わかりやすい文章を書くためにはある程度の知識が必要です。 認知速度：伝えたいことを認識するまでの時間が短い。 一義性：文の内容の解釈がひとつしかない。 を「わかりやすい文章」と定義し、その参考になる本を「必須書籍3選」「オススメ書籍10選」まとめました。 必須書籍3選まずは、購入必須だと思っている「必須書籍」です。選出理由は以下です。 これがないと文章を書く仕事ができないレベル 文章が出てくる場面ではどこでも使うことができる ライティングのレビュー時にも根拠として示せるようなものになる 代わりになるような本があまりない 他人からの評価も高い 日本語スタイルガイド

ハコベルシステム開発部のおおいし (@bicstone) です。普段はフロントエンドエンジニアとして物流DX SaaSプロダクトの開発を行なっています。 この記事ではハコベルの開発チームが心理的安全性の向上を目的に採用した、プルリクエスト (マージリクエスト) コメントにラベルを付ける手法についてご紹介します。 背景 プルリクエストをレビューする時、レビュアーとして上から目線になってしまい相手を傷つけないか緊張したり、ちょっとした確認のつもりで書いたコメントが修正必須と捉えられてしまったりした経験はないでしょうか。 本来、ピアレビューは対等な関係であるはずなのに、レビューする側の方が上になってしまいお互いに恐縮してしまいがちです。「勘だと怪しいけど間違っていたら怖いから言えないな」や、「将来的に辛くなりそうな実装だけどわざわざ指摘するほどでもないな」など荒波を立てずにApproveしてしま

テクニカルライティングの基本を学べます。サイボウズの新入社員向け研修資料です。業務マニュアル、報告書、仕様書、技術解説書などのドキュメントを書く機会がある方向け。 Twitter：https://twitter.com/naoh_nak 2023年度のアップデート版もあります：https://spe…

オンボーディング ハンドブック #このサイトについて #NTTコミュニケーションズ(以降、NTT Com)社内で製作したオンボーディングハンドブックの内容を、より一般化して広く公開するものです。 ソースコード #本書のソースコードは https://github.com/nttcom/onboarding-handbook で公開しています。 ライセンス #NTT Communications Corporation 作『オンボーディング ハンドブック』は クリエイティブ・コモンズ 表示 - 非営利 - 継承 4.0 国際 ライセンス で提供されています。 関連ハンドブック #リモートワークの働き方に特化したリモートワークハンドブックや、チームビルディングのプラクティスをまとめたチームビルディングハンドブックも参照ください。 読み始める #こちらから本編に進めます。 はじめに

はじめに エンジニアにとって、仕様書などの技術的な文章を書くこと（テクニカルライティングとも言います）は避けて通れません。ただ20年来多くのエンジニアの方々と同僚として接してきて思うことは、エンジニアの方の中には「文章を書く」ということに苦手意識がある方が一定数いるということです。 でもこの「テクニカルライティング」のスキルは、才能というよりは一種の「技能」だと思うんです。ある一定の原理原則を理解して実践を繰り返すことで、必ず一定レベルで習得できるものだと著者は信じています。 もしこのテクニカルライティングの原理原則をまだ体系的に学習したことがない、または過去学習したが改めて再学習したいという方に、お勧めのコンテンツを見つけたのでご紹介します。 https://developers.google.com/tech-writing Every engineer is also a write

The perils of the modern communications conveyor belt that never ends, divides your attention, fractures your time, and chains you to FOMO. Group chat is like being in an all-day meeting, with random participants, and no agenda Over the past few years, persistent group chat tools like Slack and Microsoft Teams have taken hold — and strangled companies. What began as a novel way to quickly communic

ゴシック体 明朝体 丸ゴシック すべて カッコのみ Hiragino Noto 横書き 縦書き w100 w200 w300 w400 w500 w600 w700 w800 w900 0.625rem 0.75rem 0.875rem 1rem 1.125rem 1.25rem 1.5rem 2rem Before 「約物半角専用のWebフォント」を優先的に当てることによって、Webテキストの日本語に含まれる約物を半角にすることができました。例えば「かっこ」や『二重かっこ』、【バッジに使いそうなかっこ】などを半角にできます。ウェイトは9種類。Noto Sans JPに沿っています。 <!-- HTML：CDNリンクを貼り付け --> <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/yakuhanjp@4.1.1/dist

2021/3/16 初めて記事を書いてから３年以上経過してしまったので、 内容を見直ししました。 関係者が10名以下の小〜中規模案件の開発・保守が多い弊社のCSS・JavaScript規約（にしたい）です。 長くなってしまったコーディング規約もようやく最後です。 ↓関連 環境構成編 HTML編 CSS、JavaScript は数年で書き方が変わってしまうので、 定期的に規約の見直しができると理想ですね。 小〜中規模サイトのフロントエンド・コーディング規約　CSS編 ディレクトリ構成 CSSに関するファイルの一般的な例を示します。 ルート ├ src ... 作業ディレクトリ │　├ scss │　│　├ lib ... 外部ライブラリなど │　│　├ sprite ... spritesmith などで生成したファイル │　│　├ foundation (base) ... 変数や mix

Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? リキッドレイアウトのように幅が常に変動するレイアウトのデザインは、動かないカンプからは実際の挙動が読み取れず、デザイナーの意図が汲み取りきれないことが多い。また、複雑化するアニメーションの実装においても、カンプだけではコミュニケーションに不備が生まれてしまう。ほかにも、CMSを使った案件ではデザインカンプと実際のデータの間に齟齬がある可能性もある。 実装効率を高めてスケジュール通りに仕事を終わらせるには、とにかく事前に仕様を固めることが大事だ。ワイヤーフレームやデザインの途中の段階からなるべくデザイナーとコミュニケーションを重ね、想定外

Join 150K+ monthly readers. In-depth articles on Node.js, Microservices, Kubernetes and DevOps. Writing clean code is what you must know and do in order to call yourself a professional developer. There is no reasonable excuse for doing anything less than your best. “Even bad code can function. But if the code isn’t clean, it can bring a development organization to its knees.” — Robert C. Martin (U

「子ども」と「子供」、書き方としてはどちらになじみがあるだろうか。ここ数年、差別助長を防ぐため「障害者」の表記を「障がい者」に見直す動きが広がっているが、実は「子供」も「差別的な印象を与える」として長らく敬遠されてきた。 行政でも「子ども手当て」「子ども・子育て支援法」など「子ども」が優勢だが、ここにきて文部科学省が「子供」表記の統一に乗り出した。 「子供」のイメージは「お供え物」「お供する」 文科省が2013年6月下旬、公用文中の「子ども」の表記を「子供」に統一した、と複数の新聞が報じた。同省の公文書では常用漢字を使うのが原則だが、「こども」については漢字の「子供」ではなく「子ども」が多用されてきた。「供」という字が「お供え物」「お供する」などを連想させ、差別的な印象を与えるというのがその理由だ。 しかし一方で、漢字とひらがなを交ぜて表記する「交ぜ書き」を問題視する声も以前からある。「は

表記ゆれを一発変換! 電話番号表記統一シート save_alt資料を無料でダウンロードするplay_arrow マージ（名寄せ）とは マージ（merge）とは、2つのものを併合するという意味で、マーケティングにおいてはリストの整理や重複チェックといった意味で使われています（日本語では「名寄せ」とも言われます）。そこで今回は、マージの中でも特に頭を悩ませる「企業リストのマージ方法」について執筆します。 マージ（名寄せ）が重要視される背景 近年、リストの管理はSFAやCRMなど、クラウド上で管理をすることが多くなってきました。これらは誰がどこにいても入力や編集、閲覧が出来る便利なツールである一方、誰でも入力できる環境であるからこそ、データの不備や重複に課題を感じている企業も増えていくことと思います。そのため、入力や編集の際のルールを統一して運用をしていくことが望ましいと言えます。 しかしながら

この1ページの質問表は、チームで効果的なフロントエンドガイドラインをつくり一貫性とまとまりのあるコードを共に書けるようにする為の補助ツールである。 HTML HTMLの方針 HTMLを書く上でのチームとしての基本方針は何か？ (例： セマンティックなHTML5マークアップを書く, アクセシビリティ, 等。 これらの 資料 を 参照) HTML Tools HTML プリプロセッサーを使用しているか？ (例： HAML, Jade, など) テンプレートエンジンを使用しているか？ (Mustache, Handlebars, など) バックエンドの構成はフロントエンドに影響するか？ (例： WordPress はマークアップのクラスにwp-paginateを加える) もしあれば, そうしたルールをについてさらに説明できるか？ HTML 記述のスタイル スペースかタブか？ コメントルールはどう

You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert

この記事の大雑把な内容 この記事は、Webデザイナー出身の現リスティング広告担当者が、自社または外注先にイメージ広告を発注する際の「デザイナーさんにスムーズに気持よく仕事をしてもらうための注意点」をWebデザイナー目線で紹介しています。 記事の最後に、弊社で使用しているイメージ広告発注仕様書をダウンロード出来るようにしてありますので、必要がある方はどうぞご使用ください。また、現役Webデザイナーの方で、「こういうのが困るんですよね」などあれば、はてぶのコメント欄にでも記載してください。みなさんで共有し、今後の改善に役立てていければと思っています。 すっかり涼しくなり、我家の猫もそろそろ丸まり始める季節となりました。 セミの鳴き声もすっかり遠くなり、「あー、楽しかった夏も終わってしまったのですね感」が満載な時節です。季節の変わり目は、猫が丸まり始めるだけでなく、いろいろな店舗や企業が、あらた