タグ

関連タグで絞り込む (1)

タグの絞り込みを解除

qiitaとwritingに関するyuki_2021のブックマーク (4)

  • 良い文章の書き方とコツ、重要スキル:「パラグラフライティング」の解説 - Qiita

    記事では、「良い文章」を書くための重要スキルである「パラグラフライティング」について、内容の解説、実践方法、学び方を紹介します。 【※NEW】22年6月新記事:スクラム関連の研修・資格のまとめ & おすすめの研修受講方法 残念ながら日の大学では、良い文章を書くための重要なスキルである「パラグラフライティング」について、ほとんど教えてもらえません。 しかし新人に限らずですが、パラグラフライティングを意識し、読み手に伝わりやすく、読んでいて苦にならないような良い文章を書くことができると、仕事の早さや質は劇的に変化します。 パラグラフライティングのスキルを知り、少しでも意識していくだけで、文章力は大きく変化します(偉そうに書いていますが、私もいまだに完全な習得に向けて、日夜、改善の日々です)。 記事は、私の「新人&新人メンター向け記事シリーズ」の第2目となります。 (1目はこちら)「効

    良い文章の書き方とコツ、重要スキル:「パラグラフライティング」の解説 - Qiita
  • 伝わる文章作成の基本を学ぶための記事・学習コンテンツのまとめ - Qiita

    短いメッセージを書くことはできても、まとまった文章を書くのに苦労している人は多いのではないでしょうか。 この記事では、まとまった文章を作るときの技術を学ぶことができる記事や学習コンテンツを紹介します。新人エンジニア向けです。 文章の「型」を学ぶ まとまった文章を書くには、「型」が必要です。頻繁に使うものは、「型」を覚えてしまいしましょう。 バグレポートの書き方を学ぶ エンジニアとして書く文章の代表例が、バグレポートです。 バグレポートでありがちな失敗として「何が問題だと思っているのか」が伝わらないというものがあります。 これを防ぐために、「期待する結果」「実際の結果」「再現手順」の3つを必ず書くようにしましょう。 質問の書き方を学ぶ エンジニアが扱う技術は、最初はわからないことだらけです。 それを解決するために、質問の文章を作成する技術が必要となります。 概ね下記の4つの情報があれば、良い

    伝わる文章作成の基本を学ぶための記事・学習コンテンツのまとめ - Qiita
  • 実践テクニカルライティング - 開発者が「外国語」を使うときの言語技術達3つ - Qiita

    言語技術 というものをご存知でしょうか。 言語技術とは、思考を論理的に組み立て、相手が理解できる様に分かりやすく表現すること。 人前で話す能力や議論の能力、文章を書く能力や論文を書く能力はトレーニングによって身につけられる。我々開発者にとっても、普段の語彙に距離のある相手、たとえば非技術者との会話の際にこの言語技術を意識することがキーになる。記事のタイトルは「外国語」と書いたが、英語は勿論、開発者にとって顧客や非技術者は時として「外国人」。開発者にとって、例えば 英語学習 テクニカルサポートのやり取り の時等に使える、情報を整理する言語技術とツールについて、3つのトピックからまとめた。 『外国語を身につけるための日語レッスン』に学ぶ、言語技術 『情報を整理するたった5つの方法 LATCH』 Google Sheets 等で、「外国語」を使う相手と状況共有をうまくする仕掛け 1. 『外国語

    実践テクニカルライティング - 開発者が「外国語」を使うときの言語技術達3つ - Qiita
  • Google社のテクニカルライティングの基礎教育資料がとても良かったので紹介したい - Qiita

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

    Google社のテクニカルライティングの基礎教育資料がとても良かったので紹介したい - Qiita
    yuki_2021
    yuki_2021 2020/05/25
    ふーん重要なことだ。理科系の作文技術を思い出した。
  • 1