はじめに この記事には、Googleのオンサイト面接に向けて勉強した内容が記載されていますが、それらはすべて面接を受ける直前に書いておいたものです。このエントリを読むことで面接で聞かれた内容が予測されてしまわないようにそのようにさせていただきました。ご了承お願いします。 この記事について 令和元年に医師を退職し、ソフトウェアエンジニアに転職します。 自分にとって大きな転機であったのと、とても大変な道のりであったので、私という人間が辿った道筋を最初から最後までちゃんとまとめておきたいと思いこの記事を書くことにしました。 私のような他業種から未経験での転職を目指されている方にとっても、何らかの参考になる内容であれば幸いです。 私の生い立ち 私は小さい頃からテレビゲームが大好きで、学校から帰るとずっと家でゲームをしている子でした。あまりにもゲームが好きだったので、遊ぶだけではなく自分で作ってみた
テクニカルライティングの基本を学べます。サイボウズの新入社員向け研修資料です。業務マニュアル、報告書、仕様書、技術解説書などのドキュメントを書く機会がある方向け。 Twitter：https://twitter.com/naoh_nak 2023年度のアップデート版もあります：https://speakerdeck.com/naohiro_nakata/technicalwriting2023
文章の書き方に正解はない。 ただ、ちょっとした「コツ」みたいなものはあると思う。 僕は会社に入ってから9年間、「週刊文春」と「文藝春秋」の編集部で、文章に携わる仕事をしてきた。 たかだが10年足らずの経歴で何を偉そうに、と思われる方もいるかもしれないが、最近になってようやく、「文章を書くコツみたいなものがあるのではないか？」ということに気がつき始めた。 もちろん一流作家のような芸術的で天才的な文章を書くコツではない。文才の有無は関係なく、誰でもそれなりに整った文章を書くためのコツだ。 noteをやっている人の中には「何かを書きたい、でもどうやったら書けるだろう」と思っている人がいると思う。また、「書きたいんだけど、素人の書いた文章みたいに読まれたら恥ずかしいな」と思って、躊躇している人もいるかもしれない。 さらに、「周りから『何でもいいからとりあえず書いてみたらいい』と勧められるんだけど、
関大岩本ゼミのアドミン @iwasemi_kuuu マーケティングや経済学や実践的なビジネスを対面とオンラインとハイブリッドで学ぶ関西大学商学部岩本ゼミの非公式兼たまに公式アカウント。 アドミンの専門はMKTG(政策)論と学説史。 質問箱→peing.net/ja/iwasemi_kuuu Note→note.com/iwasemi iwamotozeminar.uijin.com リンク note（ノート） 岩本ゼミにおけるレポート・論文の書式の基本ルール｜関大岩本ゼミのアドミン｜note レポート及び論文では「基本的な能力を有した日本語ユーザーであれば誰でも理解できる（誤解しない）」精確な（＝精密で的確な）日本語を書くことが求められます。その能力を身に付ける第一歩として，以下のルールを必ず守ってください。中には瑣末なモノも含まれますが，これらを守るだけで添削・修正の手間も再提出の可能性
『理科系の作文技術』を久しぶりに読み返し、とにかく「6 はっきり言い切る姿勢」「7 事実と意見」だけは絶対にみんな読んだ方がよい、と思った - Magnolia Tech
理科系の作文技術（リフロー版） (中公新書) 作者:木下是雄発売日: 2016/10/14メディア: Kindle版 いまさら紹介するまでもないけど、とりあえず作文方法を学びたい時は、まずはこの「理科系の作文技術」を読むことをお勧めする。 最近ブログのエントリをざっと書いてそのまま公開してしまうことが多かったので、少し反省し、それを直すためにこの本を改めて読み直した。そうしたら、タイトルで全部言い切っているのだけど、とにかく「6 はっきり言い切る姿勢」「7 事実と意見」だけは絶対にみんな読んだ方がよい、と思った。 日常的にメールや、ブログの記事など、それなりの量の文章を書くことが多いけど、論文や雑誌の記事など、きちんと他人の目を通した上で公開される文章を書くことは、まずない。一度だけ、雑誌の記事原稿を書いたとき、自分なりにかなりの推敲を重ねたつもりでも、プロの編集の方から見れば言葉使いや、
正解などない読書感想文の、正解と言える書き方
小学生の子供がいる増田・ブクマカもいるだろ、その中に読書感想文が苦手だった奴いるだろ。8月も終わりに近づいてきて、そろそろ「かーさんとーさん、読書感想文ってどうやって書いたら良いの」が来る頃だろ。安心しろ、読書感想文でナントカ賞をいくつも貰った私が書き方を伝授してやる。これは私に娘息子が生まれたら伝授する一子相伝の技にしたかったんだが、そんな予定は一切なく、今後一生ないだろうという見通しになってしまったので全国公開だ。滅びよ人類。 そもそも、コロナ禍で3月4月休みだったけど夏休みはちゃんとあるのか？読書感想文の課題って今でもあるのか？しらねえ、書きたくなったから書くんだ。書かせろ。 本の選び方 なんでもいい。薄ければ薄いほどいい。読みやすいからな。課題図書じゃないと駄目っていう狭量な小学校なら課題図書でいい。私くらいになると増田でも書ける。あとで実践編やるので期待せず待て。 感想の書き方
はじめに 2年半前の私は、IT系の会社に勤めている30代後半の平凡なサラリーマンでした。 その時点では、社外での発表経験なし、社外での勉強会の参加経験なし、技術記事の投稿経験なしでした。 そんな私が発信活動を始めたことで人生が変わりました。 今は凄く楽しいエンジニアライフになり、以下のような事が起きました。 複数のITエンジニア向けコミュニティに所属して楽しく交流 「Serverless LT初心者向け」というコミュニティを立ち上げて運営 Developers Summit 2020 KANSAI でベストスピーカー賞1位を受賞 ITエンジニア向けの月刊誌「Software Design」で連載記事を執筆 すべては発信活動を始めた事がきっかけでした。 発信活動を始めると素敵な事がいっぱいあると知ってもらう事で、発信活動を始めるきっかけになれば幸いです。 (長いので要点を知りたい人は太字のみ
難関中学の入試問題の原作者になったけど設問が解けない理由を考えて、編集者にたどり着いた｜岸田奈美｜NamiKishida
2023年2月3日、日付が変わるギリギリで思い出した豆をひとりで、鬼のお面をしながら、四方八方にまき散らしていたときでした。鬼みずから。少子化。 「岸田奈美さんのエッセイが、難関中学の今日の入試問題に出ました！」 なんですって！ 調べたところ、東京の筑波大学附属駒場中学校だった。都内……偏差値……1位……！？ 昨年は、京都大学医学部の入試でミャンマー行きのエッセイを、灘中学校の模試でバズった母のエッセイを使ってもらった。偏差値が、偏差値が軽々とスキップでわたしの頭を飛び越えていく。 出題されたのは、光村図書「飛ぶ教室 第65号(2021年4月発行)」に寄稿し、「ベスト・エッセイ2022(2022年8月発行)」に転載されたエッセイ。 ダウン症の弟が、ガラスを割った罪を、近所の子どもからなすりつけられそうになったときのこと。なつかしい。 設問も一緒に、読ませてもらったから、解こうとした。 結果
Hiromitsu Takagi on Twitter: "この解説記事、解説だと思って読むと、サラッととんでもない新事実が書かれてる。1面スクープ並みの新事案発生じゃないの？ https://t.co/4khOA7rsya https://t.co/TsLmEkT6LN"
この解説記事、解説だと思って読むと、サラッととんでもない新事実が書かれてる。1面スクープ並みの新事案発生じゃないの？ https://t.co/4khOA7rsya https://t.co/TsLmEkT6LN
いまちょうど『文章力が、最強の武器である。』という本を読み終えたところです。 これで、ついに出そろいました。 長らく追い求めていた「文章力」の理想郷。 どうやらそこには、4人（冊）の四天王がいらっしゃったようです。 これまで「文章力」「文章術」「書き方」と検索して、約20冊近く読んできました。 その中から選び抜かれた四天王をご紹介します。 入門編『文章力が、最強の武器である。』藤吉 豊 https://amzn.to/3njBbiF 最初に四天王の1人目、入門編で待ち構えているのがこの『文章力が、最強の武器である。』。 まず何と言っても、章立てがすごく魅力的なんですよね。 第1章は、文章力が劇的に上がる「3つの視点」。 おもしろい わかりやすい 読みやすい この3拍子が揃った文章こそが、「良い文章」なのだと筆者は語っています。 その後、先ほどの3拍子それぞれを伸ばしていくための考え方・型・
世の中にはプログラマー35歳定年説というものがあった。昔からそんなのはないという人と、あるという人がいた。40代も半ばになったときに「あぁ、これが35再定年説の根拠か」というものがなんかちらほら見えるようになってきたので書いてみようと思った。 世の中にはものすごいプログラマーというのはやっぱりいる。なんなら死ぬまでプログラミング書いていられるという人たちもいる（ブラック的な意味ではなく）。そんな彼らからしたらプログラマー35再定年説とか意味がわからない都市伝説にしか映らないだろう。 だが、普通に職業プログラマとして生きている俺のような人からすると、この35歳定年説はかなりの真実味を帯びている。 だが、そんな俺でも40代半ばまで延命できたのはやはり技術革新のおかげかもしれないが、結局平均寿命が伸びただけとも言えるだろう。 まず、技術に対する姿勢が変わる。正直言うとプログラミングとかもうしたく
この記事は、執筆業を15年（専業5年／副業10年）ほど続けている人間が、どのように原稿を書いているかを解説する、執筆メイキング記事です。 私が2年、寄稿していた『本の雑誌』新刊レビュー原稿を例として、初稿から完成稿までどのようにバージョンを重ねているか、説明します。 ◆【前置き】この記事を書いた背景◇想定読者想定読者は、「原稿をなかなか書き出せない人」「原稿を書くのに時間がかかる人」「原稿を思うように書けずに苦悶している人」です。 ◇きっかけもともと本稿は、執筆に悩む家族のために書いた、家庭内閲覧用の文書です。 家族（執筆の専業経験なし）は、たまに専門領域の記事や書籍の執筆依頼を受けて書いています。執筆するたびに「書けぬ……書けぬ……もうだめだ……」とうめきつつ、どうにか書き上げるのが風物詩でしたが、今とりかかっている原稿はとりわけ難産らしく、毎日「何の成果も！得られませんでした！！」状態
「本当にやりたいこと」を効率よく見つける方法。紙に “○○” をどんどん書き出すといい - STUDY HACKER（スタディーハッカー）｜社会人の勉強法＆英語学習
ドミニカン大学カリフォルニア校の心理学教授、ゲイル・マシューズ氏が行なった実験によると、目標は頭のなかだけで考えているより、書き出したほうが達成率を高めるそうです。しかし、書き出したものが自分の気持ちを無視した目標だと、あまりいい結果は望めません。 自分が本当に望む将来にしたいなら、まずは「やりたくないこと・できないこと」を言語化してみるのがおすすめです。その理由と、筆者が実際にやってみて感じたことを紹介しましょう。 自分に合わない道を選んでしまうナゾ 不確実性を強く嫌う人間の性質 自分の立場を失ってしまう恐れ 自分が望む方向へと進むには 自分ができることは特定しにくい 自分の望みを聞かないと大きなストレスに 「やりたくないこと・できないこと」を書いてみた 自分に合わない道を選んでしまうナゾ マーケティング戦略のコンサルタント、ドリー・クラーク氏によると、私たちは将来の方向性を決めるにあた
アナウンサー、コラムニスト、ラジオパーソナリティ、コスプレイヤーなど、さまざまな領域で活躍する宇垣美里さん。今年の3月には5年間務めたTBSを退職し、さらに活動の幅を広げようとされています。 火曜パートナーを務めるラジオ『アフター6ジャンクション』では、筋の通った言動から"宇垣総裁"の異名を取るなど、注目を集める彼女。常に他者からの評価にさらされる厳しい世界に身を置きながらも、なぜ宇垣さんは“自分“を見失うことがないのでしょうか？ 正解探しをしていたという新人アナウンサー時代から、話題を集めた「マイメロ論」のその後、そして宇垣さんの思う「自分らしさ」などについて伺いました。 共演者の一言で正解探しをやめた 大学では国際政治学を専攻されていたそうですね。卒業後の進路は記者を志望されていたとか。 宇垣美里（以下：宇垣） もともと書くことが好きで、国語の成績がほかよりも良かったりもしたので、文章
コード書く以外の仕事上暗黙的に必要とされている様々なスキルについてブレストしてみる - stefafafan の fa は3つです
前提 僕は新卒からいまの会社に入って以来ずっとWeb系アプリケーションエンジニアとして仕事してきました 自分がWeb系のエンジニアとして成長するにあたって必要なスキルについて考えたときに、ただコードが書けるだけでは評価されないだろうなということだけ何となくわかっているつもりだけど、言語化しないとどういうスキルがあるのか何が自分に足りないのかがわからない気がするので一旦ブレストしてみる 出来上がったリストを元に次にどこを集中的に伸ばすべきかというのがわかるのではないか ここでいう暗黙的とは、僕が学生の頃「Web系のアプリケーションエンジニアに必要なスキルはこれだろうな」と考えたときにきっと思い浮かばなかったもののことですが、人によってはこんなこと当たり前だろうと思うかもしれません ブレスト結果 いくつかブレストした結果をグループごとにわけてみた。（ブレストといってもただパソコンに向かって箇条
文章は、「これで伝わるだろう」という淡い期待を簡単に裏切ります。伝えたいことを期待通りに伝えられるようになりたいのなら、「表現の質」を高めるための推敲の技術の習得が不可欠です。 この記事では、大切ながら手間のかかる推敲を「効率的に」実施する方法を紹介します。ほとんどはじめて論文を書くことになった学生さんが、論文原稿（卒論・修論）の価値を飛躍的に向上させるうえで役にたちます。また、論文に限らず、「正しく、詳しく、丁寧に伝えたい」という気持ちで文章を書こうとする場合には、さまざまな場面で使えるはずです。 この記事で紹介する推敲の手段は、「切り分ける・並び替える・繋ぎ方を変える・削り落とす・一貫させる・まとめる・明確にする・限定する・やさしくする」の９種類です。この９種類さえ自由自在に駆使できれば、論文の文章を劇的に良くすることができます。この９種の推敲を、「まず工事して、片付けて、最後に気遣い
今年35周年を迎え、12月9日（金）には劇場映画「映画 かいけつゾロリ ラララ♪スターたんじょう」も公開される大ロングセラー「かいけつゾロリ」シリーズ。12月7日（水）発売の『かいけつゾロリきょうりゅうママをすくえ！』でなんと72冊にもなる大シリーズの作者、原ゆたかさんはどのように物語と絵をかかれているのでしょうか。制作秘話を伺いました。 児童書作家になったのは？ 私は『ちいさなもり』（1975年／フレーベル館刊）という自作の絵本は作っていましたが、元々は作家ではなく、他の作家さんの書いたお話に絵を描く画家でした。 子どものころから絵を描くのが好きで、ずっと描き続けていましたし、映画も好きだったので、絵本や児童書ならば、お話を絵で演出することができると考えて児童書の画家を目指しました。 当時は、児童書の挿し絵というと、一般的には出版社から指定された場所に絵を描くスタイルでした。でも、私は限
プログラミング言語のお作法から外れたコードやメンテ性が悪いコードを書くのはダメとよくいわれます。わたしは学生の頃、そういう意見を過剰に気にしていました。コードを書くことそのものに慣れていないのに綺麗に書こうとして手が動かず、動かないがゆえにコーディングの練習が進まない、という悪循環になっていました。そうすると何もアウトプットしないまま知識だけが増えていって、自分がこれくらいできそうというイメージと実際のプログラミング能力とのギャップで苦しみました。 この意識が薄れたのは、あるときものすごく手が早い人のコードを偶然見たときでした。たしかにちゃんと動くものができているんですが、そのコードの中身は当時の私の基準からいって*1おぞましいほど汚いものでした。そこで「これはわたしが書けば100倍くらい綺麗なコードを書けるんでは…」と一瞬思ったんですが、その後すぐに「あ、自分は知識はあるけど練習してない
西村マサヤ @masayaquality 今日、違う部署の新卒から「わかりやすい文章を書く方法を教えて欲しい」と言われたので、このリストを送ったのだけど、ほんとこの20個意識するだけでだいぶ変わると思うな。 新卒や学生はぜひ実践してみてほしい。 pic.twitter.com/JrUgbpmD53 2020-05-26 22:50:51
誰にも読まれなくても文章を書く - phaの日記
もう20年くらい、ずっと文章を書いている。最初は趣味で、ウェブ上の日記に思ったことを書いたりしていただけで、読むのは知り合いくらいだったのだけど、いつの間にか顔も知らない人に読まれることが増えて、書くことでお金をもらうようにもなった。 だけど、文章を誰かに褒められたり、文章でお金をもらえたりするとうれしいのはうれしいけれど、それはあくまで二次的なものだという意識がある。 僕が文章を書くのは自分のためだ。自分が何かを考えたいから書くし、自分が何かに納得したいから書く。書かないといつまでも同じところを堂々巡りしてしまうけれど、書くと思考や人生が前に進むような気がする。 生物というものが食べ物を摂取して排泄するように、自分にとって何かを読んで何かを書くことは、生きることと一体化しているような感じがある。 いや、もっと大きい理由は、書くことに圧倒的な快楽があるからだ。どんな快楽よりも文章を書くこと
コードレビュー虎の巻 - Qiita
レビューガイドライン(Review GuideLine) ここで述べているレビューはピアレビューについての方法です。 （作業成果物の欠陥と改善の機会を探すレビュー） 「最悪を最初に」を基本としてレビューすべき、 たとえば、仕様やアルゴリズムに欠陥があるのに、typoにこだわってもしょうがないので、なにが最悪かを考え、それを防ぐための物からレビューをします。 誤りがプロダクト全体に影響し、手戻りのコストが高くつく、あるいは失敗するようなリスクがないかを考慮にいれてレビューの対象を選択します。 たとえば、基本的な初期フェーズの要求仕様や、クリティカルな決定の基礎になる仕様、使用頻度が高いモジュールなどを重点的にレビューします。 以下に書く項目はレビュアーに負担をかけないようにするのが前提なのでレビュアーに出す前にそもそもテストしたい項目です。 参考： あなたのおっしゃるレビューってどのことかし
いつも不完全燃焼だった42歳。追いつめられて頑張りに優先順位をつけたら、本気で生きられた | サイボウズ式
おしゃれにお金と時間をかけるのをやめる。（自分に自信がないからおしゃれに頼ろうとする。清潔であればいい） 革靴を履くのをやめる。（スニーカーを履くことで行動的になれる） コンタクトレンズをやめる。（そんなもん、つけている時間がもったいない） お酒を飲むのをやめる。（健康診断で注意を受けたのが良い機会だった） ビジネス書を読むのをやめる。（他人の理想像を聞いても仕方がないから。小説や随筆を読むのはやめない） ワクワクしない仕事はできるだけしない。（年を取ったので、断ること自体はそんなに難しくない） 苦手な仕事はしない。（得意なことをもっと得意になるための努力をする） 絶対に自分ひとりで仕事を抱えない。（仕事はすべてチームでやる。そうじゃないと自分が困るから） 付き合いたくない人とは付き合わない。（逆に言えば、仲良くしたい人をもっと大切にするということだ） ちやほやされたがるのをやめる。（もう
なんとなく、一度僕の書評・感想記事の書き方についてまとめておこうかと思った。先日下記のようなブログに関する記事を寄稿したところ、幾人かがこれに触発されてブログを書いてくれたようで、個人的に嬉しかったから、というのが大きい。 blog.hatenablog.com 書評(でも感想でもなんでもいいんだが)の書き方の正解を教えるとかそういうわけではなく、単純に僕がどうやって記事を書いているのか、書くときに何を考えているのか、ということの簡単なまとめである。人によって感想ブログといっても書き方は全然違うはずで、書き方の違いを見比べてみるのもおもしろいんじゃないか。 手順 当たり前だが一度通読する。その時点でブログに書くかどうかを検討して(書かないことも多い。あまりおもしろくないな、と思ったり、おもしろいと思ってもタイミングを逃すこともあるし、書きづらくてスルーしてしまうこともある)、載せる、となっ
子どものころは絵を描くのが好きだった。 学校の休み時間は、クラスメートはみな外にサッカーをしにいっていたが一人教室にのこってノートに漫画を描いている、そんな小学生だった。 自宅に戻っても、自室にこもってよく漫画を描いていた。 漫画と書くいっても、別に人を楽しませるために描いているわけではなかった。もちろん褒められると嬉しかったが、それが目的だったわけではなく、いま思えば、それは自分で自分を癒すかのような行為だった。自分を救うために絵を描いていた。 絵を描いているときは、それに夢中で没頭していて、ほかの何にも代えがたい時間を過ごすことが出来た。この時間が、どこか自分の救いになっていた。 中学二年生ぐらいになって思春期にさしかかった頃だろうか。教室で絵を描いていると浮いてしまうことに気づいて、恥ずかしくなって、描かなくなった。 それでもやっぱり絵を描いたりなにか作品を作ったりするのは好きだった
12月であるし、アドベントカレンダーが回っていたりして、よくできた興味深いブログの記事を目にすることが多い。 よくできた記事ばかり見ていると、自分もちゃんとしたものを出さなければ、となってしまうことがありそう。しかしちょっと待ってほしい。 ブログ記事、といっても、プロの編集の手が入ったお金のかかった記事、一人で頑張って書いた大作、チョロっと書いて出てきた日記まで様々なものがある。 100文字くらいで終わっているものもあれば10万文字くらい書かれているものもあるので、文量に1000倍の差がある。 映像の世界で1000倍の差を出そうとすると、2時間すなわち7000秒の映画と、スマホで撮った7秒の動画、くらいの差がある。 2時間で観れるすばらしい映画がなにかあるとして、 Amazon.co.jp: フォレスト・ガンプ／一期一会 (字幕版)を観る | Prime Video これの1000分の1の
組織にテストを書く文化を根付かせる戦略と戦術（2019夏版） / Strategy and Tactics of Building Automated Testing Culture into Organization 2019 Summer Edition
デブサミ夏 【B-4】 2019/07/02 13:15 ～ 14:00 https://event.shoeisha.jp/devsumi/20190702/session/2077/
最近文章が書けなくなった - phaの日記
正確にいうと、書く意欲が湧かなくなった。 僕は、ネットとかにあれやこれやの思ったことを書き続けていれば人生はなんとか進んでいくだろう、と思って今までやってきた人間なので、書けなくなるのは困る。これからどんなふうにやっていけばいいんだろう。 なぜ書けなくなったのだろうか。いろいろ思い当たることはある。 ・大体書きたいことは書いてしまった ・長く書き続けてきたので自分の書くことに飽きてきた（会社をやめてブログを熱心に書き始めてから15年、最初に本を出してから10年） ・シェアハウスをやめて一人暮らしになったのでいろんな情報にさらされる度合いが減った（最近はテレビとかよく見ていて普通になった） ・ネット全体の雰囲気が自分に合わなくなってきた ・40代になっていろいろエネルギーが減ってきた かつての自分は、ツイッターに断片を書き散らす→そういうのがある程度まとまったらブログに書く→もっとまとまった
ほとんどの人は、そもそも表現者になりたいとは思ってないのでは - ふろむだ＠分裂勘違い君劇場
『誰もが表現者になれる時代はとっくに終わってるんだよ』 とおっしゃる方がいらっしゃいますが、 以下の３つは全然違います。 (1)起業家になりたいから、起業する。 (2)こういう面白サービスを思いついて、実装して、みんなに使ってもらいたいから、起業する。 (3)金儲けしたいから、起業する。 同様に、以下の３つも全然違います。 (A)表現者になりたい。 (B)こういうことを思い付いちゃったから、だれかに聞いてもらいたい。 (C)思い付いたことをネットで発信して、それで生計を立てたい。 ネットで何かを書いている人の原動力は、ほとんどが(B)です。 この記事は(B)です。 また、ネットのアマチュアクリエイターの多くは、 (D)こういうものを創りたくなったから創ったので、それを誰かに見て貰いたい。 です。 僕が今書いている小説は、(D)です。 クリエイトする人のことを「表現者」と呼ぶのは、昔っから違
「文章が下手ですみません」にいらっとする
文章の最後に「文章が下手ですみません」とか書いてあることがある。これにいらっとする。下手だとわかっているなら書き直すべきだ。下手な文章を読ませるのは失礼な行為であり、読み手の時間を奪う行為でもある。最低でも書き直すべきだし、もっと言えば、上手な文章が書けるよう、日頃から練習すべきだ。 そして、日頃十分に文章の修練をし、当該の文章を十分回数推敲して丁寧に書き上げたならば、「文章が下手ですみません」などという弁明は要らないし、そもそもそんな言葉は出てこないはずだ。自信と責任をもって、堂々と相手に読ませられるはずだ。 要は、「文章が下手ですみません」にいらっとするのは、 日ごろ鍛錬を怠っていて その文章も明瞭に書く努力を怠っていて、 つまり、「文章が下手ですみません」とは本心から思っているわけではないのに、 文章の最後に取ってつけたように「文章が下手ですみません」と書いて許してもらおうというさも
技術記事を書くまでのステップについて順にコツを解説していきます。 特に、技術記事を書きたくてもテーマ選定が難しい、文章が苦手だ、なぜか筆が進まない、うまくまとめられないといった方に読んで欲しい記事です。 一応、エンジニア歴としては数年以内のジュニアレベルの方を想定しています。 以下のように技術記事を企画して、書いて、公開するためのプロセスごとにちょっとしたコツをまとめています。気になるセクションだけでも読んでいただければ幸いです。 テーマを決めよう 対象読者を決めよう 章立てを決めよう 書こう タイトルを決めよう 【余談】技術記事を書く理由とは 筆者について QiitaとZennにて6年以上の記事発信経験があり、 Qiitaでは5,942Contributionsを記録、 Zennでは3,253Likesをいただいています。 テーマを決めよう コツ：テーマのカテゴリによって執筆のポイントや
「The Twelve-Factor App」を15項目に見直した「Beyond the Twelve-Factor App」を読んだ - kakakakakku blog
2012年に Heroku のエンジニアによって提唱された「The Twelve-Factor App」は素晴らしく，アプリケーションをうまく開発し，うまく運用するための「ベストプラクティス」として知られている．2020年になった現在でもよく引用されていると思う．日本語訳もある． 12factor.net Beyond the Twelve-Factor App とは？ クラウド化が進むなど，提唱された2012年と比較すると技術的な変化もあり，今までの「The Twelve-Factor App」で宣言されていた観点以外にも必要な観点やベストプラクティスがあるのでは？という意見もある．そこで，2016年に Pivotal のエンジニアが「Beyond the Twelve-Factor App」を提唱した．The Twelve-Factor App にあった「12項目をアップデート」し，新
分かりやすいドキュメントを書く「テクニカルライター」という仕事 / About the job "Technical writer" who writes easy-to-understand documents
もともとインフラエンジニアをしていた私が、LINEに入るまで知らなかった「テクニカルライターという職種があること」と「LINEにはテクニカルライティング専門のチームがあること」の2つについてお話しします。技術も好きだし、ドキュメントを書いたり、人に教えたりするのも好きだ、という方に「こういうキャリアもあるんだ」と発見してもらえるセッションです。 ■ 発表者 堀越 良子 / LINE株式会社 テクニカルライター。元インフラエンジニア。ねこが好き。 https://twitter.com/mochikoAsTech ■ セッション動画 https://youtu.be/nmFVXJGiCxM?t=2817 ※こちらは以下イベント内で発表した内容です https://line.connpass.com/event/205655/
感想文が苦手だった人間の気持ち
https://anond.hatelabo.jp/20200821200053 https://anond.hatelabo.jp/20200821141701 私もまた感想文は苦手だった。 感想を書いて自分の内心を外部に晒す。苦痛、恥辱、弱点を晒す、言質を取られる、そんな感情を伴う。 今でこそ「内心の自由の侵害であり、黙秘を許さぬ虐待でしかない」と言えるが、年端も行かぬ小学生にそんな抗弁もできようハズがない。 しかもこれは理由の一端である。 他にも、どんなアドバイスを受けようとも「それは自分の言葉でない」「自分はそんな事は言わない」という、 頭の引き出しの中になにもないクセに、外から来るすべてを拒絶するという性質があった。 何故なら「自分で書いたモノ」と自己が切り離されず、そのような外から来た言葉を混ぜることは アイデンティティの喪失を意味するため、拒絶するしかないのだ。 初めて「なん
設計とは、 要求（やりたいこと）をヒアリングする 要求を要件（何を満たさないといけないのか）に落とし込む 要件を実現するために考えられる手段を洗い出す 手段の検証を行う 検証結果を元に、どの手段を使うかを選定する 選定した手段を合意する（一部要件を満たさない事項がある場合は、代替策や妥協ラインについても合意する） 合意内容を元に、実装や設定に落とし込む をやることである。画面設計や機能設計のように、3-5の検証/選定が薄くなったり曖昧になったりするものはあるが、一般化するとこの流れになる。 設計書には、上記の設計でやってきたことを順番に書いていけばよい。これを文章構成のテンプレに落としていくと、 要求 要件 方式 対応案（いわゆる比較表で書いていくのが楽） 検証結果 選定・合意結果（合意した代替策や妥協ラインについても記載する） 詳細設計（どういう実装にするとか、パラメーターにするとか、細
哲学者であり作家としても活動している千葉雅也さんは、長年「書けない」悩みと対峙（たいじ）し続けてきた。 近年はSNSやブログなど、自分の言葉をアウトプットできる機会が増えた。そういった自己発信の場以外でも、企画書や取引先へのメールなど、「書く」という行為は私たちの生活と密接している。「書けない」悩みや「書く」ことへの苦手意識を抱く人も少なくないだろう。 それらの根底には「ちゃんとした文章を書かなければならない」という呪縛がある、と話す千葉さんに「書けない」悩みを克服する手がかりを伺った。 インターネットの広がりにより、ブログ、SNS、小説投稿サイトなど言葉で自己表現できる多種多様なサービスが身近な存在になった。文章を書く機会は増えたが、文章を書くハードルが下がったかといえば、意外とそうでもない。 何かを書きたい気持ちはあるのに、いざ書こうと思うと「うまく書けない」「まとまらない」。 読み手
初めて「論文」を書こうとしている人向けの、主にメンタル面（気持ち）の対処をメインにした書き方の指南書。 （ただし、メンタル面だけでなく書き方全般についても説明しています。） 筆者が査読付き論文を書くときに経験した最も大変だった（辛かった）ことは、研究の中身や書き方自体ではなく、諦めずに論文を書き上げて提出しようという意思を保ち続けること、つまりモチベーションの維持でした。モチベーションの維持は、個人の気持ちの持ちようとして片付けられがちに感じます。しかし対処方法は少しながらあるように思うのです。 本資料が、論文書きを諦めてしまおうとしている、あるいは諦めてしまった過去がある人への励ましになることを期待しています。 （10/6追記：本資料内での「レビュアー」は、自分が書いている原稿を添削指導してくれる人のことを指しています。しかし一般的にはレビュアーとは査読者のことを指す場合が多いのでちょっ
テストを書くか書かないかの状況判断 / Deciding whether to write tests - DeNA Tech Talk
2014/12/09 に DeNA 社内勉強会にお招きいただいて話した内容です
メンバーの一部がスムーズに情報共有できるチケットを書けず 苦戦しており、相談を受けた時に色々言った内容を 書き起こしたもの。 荒いけど誰かの参考になるかもしれないので共有。 2019/09/07 宣伝追記 技術書典サークル参加します。 チーム運営どう考えて何をやったかまとめた本とセキュリティの 入門書を頒布するので気になった方は是非。 https://techbookfest.org/event/tbf07/circle/5671044488626176 書いた人の環境 業務ツールとしてチャット、Redmine、Wikiを使用。 チャットで会話して相談・整理・調整する。 タスク、課題はチケット化して管理。 ナレッジはWikiに書いて共有。 業務内容はシステム開発と運用保守でソフトウェア開発ではない。 Redmineはタスク・課題管理に使用。 以下、メンバーに伝えたことを清書したもの。 前提
Search, watch, and cook every single Tasty recipe and video ever - all in one place! News, Politics, Culture, Life, Entertainment, and more. Stories that matter to you.
「書けない」に向き合う。『ライティングの哲学』を読んだはてなブロガーの感想をピックアップ！ - 週刊はてなブログ
「書き出しが決まらない」「キーボードに向き合う気力さえ湧いてこない」「何を書いてもダメな文章な気がする」……何かを書きたいと思いつめるがゆえの深刻な悩みが、あなたにもあるのではないでしょうか？ 本書は「書く」ことを一生の仕事としながらも、しかしあなたと同じく「書けない」悩みを抱えた4人が、新たな執筆術を模索する軌跡を記録しています。 書きたい気持ちはあるのに、キーボードに向かうと手が進まないーー。書き手が陥りがちなこの悩みに正面から向き合う書籍『ライティングの哲学 書けない悩みのための執筆論』（星海社新書）が話題です。 本書は「書く」ことを仕事とする千葉雅也さん・山内朋樹さん・読書猿さん・瀬下翔太さんの4人が、それぞれが持つ「書けなさ」をどうやって乗り越えているか、座談会形式で語り合ったもの。 自身も書き手であるブロガーのみなさんも、本書からさまざまな刺激を受け、思いをブログに記しました。
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
【転職エントリ】Googleに入社します｜Lillian
テクニカルライティングの基本
文才の有無に関係なく、誰でもそれなりに整った文章を書くコツ｜村井 弦｜文藝春秋
「相当まともな文章を書いてきますよ」関西大学のゼミで配布されている『レポート・論文の基礎ルール』が本当に大切なことばかり
30代後半になって初めて発信活動を始めたら人生が変わった話 - Qiita
【確定】文章力本の四天王がついに出そろった。 - BIZPERA(ビズペラ)-ビジネス書評はペライチで
もうじき40代なかばを迎えるプログラマーの遺言（少し追記）(もうちょっと追記）(さらにもうちょっと追記)
【なるべく意識を低く保て】 書けないと悩む人のための、原稿の書き方 ： 〜雑誌原稿を実例に〜｜ふくろう
宇垣美里「自分を嫌いになる場所にいる必要は、絶対にない」 - りっすん by イーアイデム
果てしない文章推敲を「３ステップ」で効率的に終わらせる方法｜石原尚（大阪大学教員）｜note
🦊「かいけつゾロリ」🦊の原ゆたか流 物語のつくりかた｜ポプラ社 こどもの本編集部
ヘタクソなコードを書いてもいい - 覚書
「わかりやすい文章を書く方法を教えて欲しい」と言ってきた新卒に送った20個の項目のリスト
書評・感想記事の書き方について - 基本読書
自分を救うプログラミング｜naoya
アウトプットの品質を下げておくと気軽に書けるようになる - hitode909の日記
なかなかアウトプットできないあなたが技術記事を書くときのコツ
設計書には何を書くべきなのか - terurouメモ
きちんとした文章を書かないといけない、なんてない。｜千葉 雅也
論文の書き方 - 主にメンタル面の対処を中心として
チケットの書き方 - Qiita
こんなに安くていいの？ダイソーの「電子メモパッド」繰り返し使えてめっちゃ優秀！
www.data-be.at
oremanga.tokyo
otonasalone.jp
www.sankei.com
www.gizmodo.jp
www.nikkei.com