「大江戸Ruby会議10」での発表資料です。 https://regional.rubykaigi.org/oedo10/
Send feedback About this guide Stay organized with collections Save and categorize content based on your preferences. This style guide provides editorial guidelines for writing clear and consistent Google-related developer documentation. If you're new to the guide and looking for introductory topics about our style, then start with Highlights, Voice and tone, and Text-formatting summary. Otherwise
自分は英語・日本語ネイティブ話者であり、英語に関しては高等教育中に少なくとも基本的な文章の書き方・プレゼンテーションの仕方は体形的に学んでいます。大学では技術方面の専攻だったせいでいわゆるテクニカルライティング的な授業も基本的なところから学んでいます。 そういう背景もあるため、仕事で英語のドキュメントを添削する機会がこれまでたくさんありました。 この記事ではこれまで色々見てきたドキュメントの中で「これだけ気を付ければ英文を書くのが得意じゃなくてもぐっとよくなるのに…」という点を書き出してみました。 期待している読者層としてはこれから英語を習うというレベルではなく、すでになんらかの形で仕事向けの報告書、プレゼンテーション、公開記事等でまとまった英語を書く必要があって、翻訳サービスや辞書を使いながらある一定レベルで一応英語書けるつもりの人です。 英作文をしてみたものの、「なんか書くときに迷う…
漢字で書ける語句をひらがなで書くことを「ひらく」、その逆に、ひらがなの語句を漢字で書くことを「とじる」(=ひらかない)、これらを総称して「(漢字の)閉じ開き」といいます。 この「閉じ開き」は、テキストの読みやすさ、伝わりやすさ、さらに、誤読を避ける気づかいなどに直結します。デザイン制作物だけでなく、メールやSNSなど、文字ベースでのコミュニケーションが多く行われている現在では、ビジネススキルのひとつです。 ライティングや文字校正では、よくひらがなを【ひらく】漢字を【閉じる】と表現しますが、僕は小学生の頃両さんに教えてもらいました😎 ちなみに1988年発売の51巻です。 相変わらずこち亀の守備範囲は広すぎる🥺#ブログ書け#ブログ初心者 pic.twitter.com/vZirFnQOCy — おかぺー🙋🏻♀️オカンのIT力向上 (@DemoOkan) May 2, 2021 ルー
こんにちは! 開発部 テクニカルコミュニケーションチーム(以下、TCチーム)の原嶋です。 さてさて。 みなさん、ドキュメントの文章校正(以下、校正)ってどんな風にやっていますか? 目視チェックでバッチリだぜ!という方も もちろんいると思うのですが、チェックポイントが多いと指摘が漏れてしまいがちですよね。そして、会社の公式文書となれば、チェックポイントはあれもこれもと山のようになります。 TCチームでも長年 校正に頭をかかえていましたが、textlint と+αのツール を使って、校正の悩みを解決しました。 今回はその経緯をお話させてください。 校正って確認する項目がたくさん TCチームでは、サイボウズ製品のユーザーサポートコンテンツ(ヘルプやリリースノートなど)を作成しているのですが、 それらのコンテンツは会社の公式文書なので、毎回の校正でチェックする項目が多々あるんです。 校正おわったー
「ご相談させていただけますでしょうか」 「ご確認させていただければと思います」 「ご報告させていただければ幸いと存じます」 …こんな文章が書かれているメールが、よく送られてくるようになった。 同業者のソーシャルメディアを覗いてみれば 「担当させていただいた仕事で、受賞させていただきました!」 …みたいな投稿がチラホラ。 テレビをつければ芸能人が 「入籍させていただいたことを、ご報告させていただきます」 …なんて記者会見をしている。 どこもかしこも「させていただきます」だらけ。なんでこんな世の中になってしまったのか?背景にあるのは「嫌われたくない」という心理だ。 ビジネスのメールであれば、「させていただきます」という書き方をするのは、相手にとってイヤな内容を書くときだ。 「納期の前倒しをご相談させていただければ幸いと存じます」 …といった感じだ。 クリエイターにありがちな「カンヌを受賞させて
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter. テキスト校正くん VS Code上でテキストファイル・Markdownファイル・Re:VIEWファイルの日本語の文章をチェックする拡張機能です。該当のファイルを開いた時、更新した時に自動で校正のチェックを行い、文章内の問題のある箇所をマーキングし問題パネルにエラー内容を表示します。 メールの文章を作成する際やブログ記事の文章を作成する際などに、ご使用いただくと便利です。 ウェブ業界の専門用語を含め、一般的な文章のルールに沿って主に以下のようなチェックを行います。 「ですます」調と「である」調の混在 誤検出の回避のため「である調」の判定は明らかに常体な「〜である」のみとなっています。 ら抜き言葉 二重否定 同じ助詞の連続使用(※初
Googleによる社内調査以降、多くの組織で「心理的安全性」が重視されるようになりました。心理的安全とは、他者の反応に怯えたり羞恥心を感じることなく、自然体の自分をさらけ出すことのできる環境や雰囲気のこと。 ですが、複業やリモートワークの浸透などビジネス環境が日々刻々と変化する中、「心理的安全性」という概念自体もアップデートさせていく必要があるはず。特にチャットやオンライン会議といったメンバー同士が対面しない「デジタル空間」における心理的安全の構築は、組織のパフォーマンスに責任を負うマネジャーにとって重要な課題ではないでしょうか。 機械学習などの分野で企業を支援するかたわら、チームに雑談を生み出すソーシャルブックマークサービス「Vein」を開発する株式会社NextInt代表・中山ところてんさんは、私たちの仕事がデジタル化したことで「心理的安全」の担保は難しくなったと指摘します。 今回は、そ
textlintでの文章チェックをVS Code上で行う方法についての話です。 textlintについては以下を参照してください。 textlintで日本語の文章をチェックする | Web Scratch Collection of textlint rule · textlint/textlint Wiki VS Codeでtextlintを動かす拡張としてvscode-textlintがあるのでそれをインストールして動かすまでの流れを見ていきます。 (vscode-textlintでグローバルの設定を使う方法はよくわからなかったので、今回はプロジェクトのローカルにインストールしたtextlintを使うまでの手順を見ていきます) vscode-textlint - Visual Studio Marketplace created by @taichi インストール VS Codeを開き
This webpage was generated by the domain owner using Sedo Domain Parking. Disclaimer: Sedo maintains no relationship with third party advertisers. Reference to any specific service or trade mark is not controlled by Sedo nor does it constitute or imply its association, endorsement or recommendation.
社内向けの教育資料を、ど素人でもわかるようにと思いながら作っていて、じゃあ「わかりやすい」って何だろうって考えてた。今まで読んできたいろんなわかりやすかった本とそうでない本を思い浮かべながら、一般的にここを注意すればわかりやすさを確保できるだろうっていうポイントを一旦まとめておこうと思った。そうしてまとめてみると、本に限らず人に何かを伝えること一般に適用される話だなと思った。 読む側の負担を減らす わからない=理解をはばむ障害物がある。この障害物を取り除く/回避する作業が「わかる」ために必要になる。その作業を、作者ではなく読者が負担するとき「わかりにくい」本になる。 日本社会だと情報の受け手の側がこの「わかる」ための作業を負うことでコミュニケーションを成立させる傾向にある。空気を読むというようなことだ。そのため発信者側が事前に手を尽くしてわかりやすく発信するというのが苦手で、相手が汲み取っ
文のレベルで、日本語を明確化する工夫について取り上げた著作には、本多勝一(1982)『日本語の作文技術 (朝日文庫)』(朝日文庫)があるが、酒井聡樹(2007)『これからレポート・卒論を書く若者のために』(共立出版)が、さらなる改良に取り組んでいる。 この記事は、両著作についての私的メモの域を出ない。 なお『これからレポート・卒論を書く若者のために』は、井上真琴『図書館に訊け!』(ちくま新書)とともに、大学新入生のマストアイテム。入学する前に読んでおくと、まるでちがった4年間を過ごせるだろう。 以下では、まず日本語の文がわかりにくくなる4大原因を示し、次に4大原因のそれぞれに対応した4つの最適化ルールを提示する。最後に、それぞれのルールについて適用例を挙げて、ルールの活用法を説明する。 文が分かりにくくなる4大原因 1.一つの文に多くの情報が詰め込まれている 2.情報を与える順番がおかしい
前回 二十一世紀にふさわしい「頑張る」を考えよう…「若い人たちに時間を気にしないで働いてもらう」騒動の本当の意味 がずいぶん盛況で当ブログの1日アクセス記録を更新したわけだが(とはいえそもそも当ブログのアクセス自体たいした数字ではない)まあ良く書けたなと思う一方で、「あー、これ書いておけば良かった」という部分が一つあった。 それは「二十一世紀の頑張る」の例で、L.starのいるソフトウェア業界に古くから伝わるプログラマの三大美徳、怠惰(Wikipediaでは無精)・短期・傲慢というやつだ。 単語だけ見るとプログラマとはなんとろくでもない職業だ、けしからん!と思うだろうが変な言葉を使うのはいわゆるハッカー的偽悪趣味の表れであって本筋ではない。 本筋の部分は@dankogai氏が昔解説した文章がよかったのでそちらを参照していただくとよろしいかと。 404 Title Not Found: #1
『坊っちゃん』自筆原稿 読みやすい文章とは、流れるように読める文章だ。難しい言葉はいらない。気のきいた言葉もいらない。文頭から文末まで振り返ることなく読める文章が、最も美しい。 読みやすさの基準は客観的なものだ。読み手には様々な人がいる。老若男女すべての人に対して読みやすい文章を書くのは難しい。ただ、綺麗な文章を書こうとする意識は持ちたい。 文章を書く上で意識すべき技法を紹介する。 常体と敬体 常体とは「だ・である」調の文章であり、敬体とは「です・ます」調の文章を指す。それぞれにメリットとデメリットがある。 常体は、自分の意思を力強く伝える事ができるが、我の強い文章になる。敬体は、優しい印象で共感を得やすいが、まわりくどい文章になる。 常体と敬体を織り交ぜて書く手法もある。まずは自分で試してみて、書きやすい文体を見つければいい。 文章の始まりは短く 最初の一文は短いほうがいい。インパクトが
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く