テックブログ執筆に役立つ心構え - paiza times
＜この記事の著者＞ ばんか（bamka） - Tech Team Journal Web制作会社の会社員（Webディレクター）として働きつつ、個人でブログ／メディアライターとしても活動するパラレルワーカー。 ChatGPT等AIを公私で駆使し、ITツール・ガジェットを用いて人々の生活をより豊かにするための活用術を提供するブログも運営。 QiitaやZennなど、ITエンジニアさん同士での情報共有を目的としたメディア。正直、Webディレクターの私が見ていてもチンプンカンプンな内容が多いのですが、それでも読み物として勉強になるので、よく拝見しています。 読む専門のITエンジニアさんも多いかもしれませんが、個人的には、自身のノウハウは積極的にアウトプットしていくのをオススメします。 「人の役に立つから」「自分の認知を広げられるから」など理由はさまざまですが、一番はシンプルに「自分のスキルとして定
小学生に教えるために編集者歴17年の父親が本気で考えた…｢きちんと伝わる文章｣を書く10のコツ ｢説明ができる｣とは｢生きる力がある｣ということ
「伝わる文章」とはどのようなものか 私はWEB媒体の編集者／ライターをかれこれ17年ほどやっている。日本語で情報を伝えるのが仕事だ。 ジャンルとしては長文の体験レポートを中心に扱ってきた。ライトな読み物で、書くのも簡単そうだと思われるかもしれない。いやいや、そうでもないのだ。それぞれのバックグラウンドを持ち観察力に優れた書き手が、五感をフルに使い数時間かけて体験取材をすると、情報量がとんでもないことになる。それを限られた字数で読者にわかりやすく伝えるのは、実は技術のいる作業なのだ。 また、私は特に編集部の中でも新人ライターを多く担当しており、書き慣れない人が書いた文章を一緒に直し、読み手に伝わる書き方をアドバイスする経験をずっと積んできた。 そんな私が、小学生の子供の中学受験によってあらためて「伝わる文章の書き方」を見つめ直すことになった。本稿ではその経験について少し語らせてほしい。
怠惰な人向け技術ブログの続け方ガイド
技術ブログの続け方ガイド こんにちは！ITベンチャー企業で半年間働いている駆け出しエンジニアです👨💻 今回はエンジニアで働く上でテックブログを続けるためのモチベーションの保ち方を記事にしてみました。 テックブログって敷居高いしめんどいよなぁ！？ 技術記事を発信する人材は重宝されるらしい。 ただ、僕は現段階で技術記事って面倒くさいし敷居が高いな〜書くネタもないな〜🐹 と思ってしまうのが事実としてあります。 僕だけなのかな？と思って調べてみたら… みんなめんどくさがってるやんけ！！！！！ そこで、めんどくさがりな僕たち向けにテックブログの続け方をノウハウとしてまとめてみました。 みなさんのモチベーション維持に貢献できれば嬉しいです👍 1. 初学的なところも書いてみる こんなの書いても誰のためにもならないんじゃないの…？😭 ということでも書いてみるのは大事である。 自身が悩んだり共感
ソフトウェアエンジニアとしての職務経歴書の書き方を考えました
この前職務経歴書を書いたので、そのとき色々考えたり調べたりしたことを書きます。 一般的な転職活動の職務経歴書は微妙だった 僕の転職は二回目です。 一回目の転職のときは、リクルートエージェントのサービスを使って転職しました。 リクルートが公開している、一般的な職務経歴書のサンプルは↓こんな感じです。 Wordで表をつくって、編年体に、何をやってきたかを書くことで、自分の職務経歴を書きます。 ただ詳細はちょっと長くなるので、職務経歴書の冒頭に数行でサマリーが書いてあって、親切ですね。 一般的な日本の職務経歴書というのは、このフォーマットで問題ありません。 実際一回目の転職のときは僕もこのフォーマットで転職しています。 二回目の転職活動も、この職務経歴書に二社目の経験を追記すればいいか、と思っていましたが、 見れば見るほどこのフォーマットで書いた自分の職務経歴書が微妙に感じてきました。 何が微妙
学術書の書評を書くということ｜まつーらとしお
『日本語の研究』に出した書評が公刊されました。 オンラインに出るのは刊行の1年後なのでしばらくは紙媒体のみになります。 学術書の書評を書いたのは2度目になります。慣れたわけではありませんが，どうやって書評を書く仕事をしたのか少し記録を取っておきます。 依頼を頂いてから締切までは6か月でした。当たり前ですが、本を入手して通読します。読むときのスタイルは色々でしょうが、書評を書くことが決まっていたので、適宜付箋を貼り付け、鉛筆でメモを書き込みました。 今回の本は直接メモを書き込んでいましたが，前の書評では付箋を貼り付けて、notionに書き込んでいました。基本的に気になったら躊躇なく付箋を貼っていったのでそこそこの量になります。 ひと通り読み終わった後，notionでメモを作りました。アウトラインとも言えるもので，基本的にこれを書こう，これは伝えたい！というものを盛り込んでいます。ちなみにno
30点で打席に立つ
めもりーさんと語るFindy Engineer Lab オフ会＠東京 LT https://findy.connpass.com/event/294069/
がんばらないObsidianノート術 - Qiita
はじめに Obsidianという素晴らしいプロダクトが登場してから、デジタルノート術は活発化したと思います。私もその１人で、今日も楽しくObsidianを使っています。 しかし、その一方であまりノート術にこだわりが強くない方や深く理解するほど価値を感じていない人の中ではまだまだ単なるメモ帳として使われている現状があります。 そこで、今回は「がんばらない」Obsidianノート術として、「こだわりすぎない」「多様な原理原則がない」形で『書く』習慣を付けるためのノート術を書きました。 そんなノート術であったとしても、今後ノートを分解していけるような構造にしておくことで、今後の拡張性を残しています。ぜひ「難しくて挫折しまった」という人はチャレンジしてみてください。 『書く』ことで整理術は生きる Personal Knowledge Managementはの概念やLYTといった考え方は斬新で、とて
魅力的な技術アウトプットを出すために心がけている7つのこと｜中川 伸一 / Engineer Manager
気がつけばめっちゃ久しぶりどころか2023年初のnoteとなります。 色々書くので一旦前置きしておきます。 なお、これは個人の見解・意見であり所属組織及び業務とは何の関係もありません。 【前説】このエントリーは技術ブログや外部登壇、はたまた就職・転職活動において、 私（shinyorke）がどうやってアウトプット（スライド・ブログ・ドキュメント）を魅力付けしているか？その考えと少しだけテクニックを紹介 することを目的としたエントリーです。 ウケる・読まれる技術アウトプットを出したい 会社の技術ブログやイベントの資料をいい感じにしたい 魅力的なドキュメント（CVなど）を作って就職・転職に活かしたい 方に刺さるような話になっている可能性がありますが、基本的に私のポエムとして読んでいただけると幸いです。 あらすじ&今年の前半戦本題に入る前にちょいとした近況報告を。 気がつけば今年も半分が終わった
なかなかアウトプットできないあなたが技術記事を書くときのコツ
技術記事を書くまでのステップについて順にコツを解説していきます。 特に、技術記事を書きたくてもテーマ選定が難しい、文章が苦手だ、なぜか筆が進まない、うまくまとめられないといった方に読んで欲しい記事です。 一応、エンジニア歴としては数年以内のジュニアレベルの方を想定しています。 以下のように技術記事を企画して、書いて、公開するためのプロセスごとにちょっとしたコツをまとめています。気になるセクションだけでも読んでいただければ幸いです。 テーマを決めよう 対象読者を決めよう 章立てを決めよう 書こう タイトルを決めよう 【余談】技術記事を書く理由とは 筆者について QiitaとZennにて6年以上の記事発信経験があり、 Qiitaでは5,942Contributionsを記録、 Zennでは3,253Likesをいただいています。 テーマを決めよう コツ：テーマのカテゴリによって執筆のポイントや
「◯◯GPT」や「ChatGPT搭載」はNG 米OpenAIがブランドガイドライン公開
米OpneAIは現地時間4月24日、ChatGPTなどOpenAIブランドを利用する際のガイドラインを公開した。ロゴマークやその利用方法、また「ChatGPT」などの文言を利用する際の注意点が記されている。 例えば、OpenAIのAPIを利用した製品について「◯◯GPT」「GPT-4搭載の◯◯」「ChatGPT搭載の◯◯」といった表現は使わず、「Powered by GPT-4」や「Built with GPT-4」などの表現を使うよう求めている。また、OpenAIのモデルを指すときはGPT-3、GPT-4、ChatGPT、DALL・Eを使い、Ada、Babbage、Curie、Davinci、GPT-3.5-turboなどのエンジン名を避けるようにとしている。
意外と知られてない、すごく効果のある文章上達法｜ふろむだ@分裂勘違い君劇場
文章上達法について、「大量に書け」派と「大量に読め」派の人がいます。 「ひたすら大量に文章を書け。文章上達にはそれしかない」というのは書け派の典型。 「まずはラノベを千冊読め。話はそれからだ」というのは読め派の典型。 しかし、大量に文章を書いているのに文章の下手な人はたくさんいますし、 ラノベをたくさん読んだけど面白いラノベの書けない人もたくさんいます。 これはスキル全般に言えることで、 たとえば、アメリカに二十年住んでいるのに英語がいまいちな人なんて、いくらでもいます。 「量をこなせば自ずと質に転換する」のは、もともと才能のある人間だけです。 私のような凡才は、量をこなすだけでは効率よく上達しません。 質の高い修練を大量にやってはじめて、効率よく上達するのです。 では、質の高い修練とはどういうものでしょうか？ それは、次の２つです。 (1)優れた文章のどこがどう優れているかを、文章を書く
読みやすいドキュメントを書くために今日からできる7つのこと｜壮｜Masato Tanaka
こんにちは。壮（@sew_sou19）と申します。 メガベンチャー企業でエンジニアとして働いています。 エンジニアにジョブチェンジした当初は、ドキュメントの書き方なんてこれっぽっちも分かりませんでした。読みやすいドキュメントを書くことが本当に苦痛だったのですが、考えて、試行錯誤し続けた結果、以下のような評価を得るに至りました。 リーダーから「君は情報の整理が上手でドキュメントが本当に読みやすい。チーム全体の能力向上に繋げたいからドキュメント書く際のポイント共有してほしい」と言われたので、意識していることを言語化しつつテクニカルライティングの本でインプットしてるけど、学びが多い。ついでにnoteにもまとめてる — 壮 (@sew_sou19) November 28, 2022 そこでこのnoteでは、僕がドキュメントを作成するときに、特に意識して実践している7つのことを書きます。（本当は2
去年は182本の記事を書いた人から見た、技術的なアウトプットに疲弊しないようにするコツ - Lambdaカクテル
文脈: blog.arthur1.dev 自分は割とガンガンアウトプットする方で、たまにバズって嬉しいという品質のブログ(これ)をやっている。普段どのような心構えでやっているのか、そして続けるコツみたいなものについて書いてみようと思う(参考になるかは全くわかりません)。 あと一応断っておくと、タイトルにある "去年書いた182本の記事" は非-技術的な記事も含んでいる(けど、だいたい技術記事なので許してほしい)。 どういうときに書くか どういうモチベーションで書くか どういうときにバズるか どのようにして続けるか 余談: 箇条書きの型を統一する 参考文献 あわせて読みたい どういうときに書くか 自分は基本的にブログを「1年前(後)の自分が泣いて喜ぶ記事」というテイで書いている。自分が知りたかったことは他人も知りたかったはずだという仮説で書いていて、それを知りたかった人の総量はその技術のシェ
技術ブログは『あとで困った時のためにメモる』ぐらいで丁度良いと思う
と個人的には思ってます。 文脈 何のために技術ブログを書くか 私は最近技術的な話でアウトプットできないのであまり大それた事は言えないのですが、 息を長く技術ブログを続ける と言うのであれば、 あとで困った時のためにこれはブログにメモっておこう と言うぐらいの心持ちで書いておくぐらいが丁度良いと思います。 私はブログを 2006年から続けて来て大分経ってますが、これはキッチリ書いて皆に伝えたい、 と言う記事が当たらずに閑古鳥が鳴くのは割と良くあった話ですし、 逆に割と雑に書いたけど何故か当たった と言う事もままある話です。 そして 技術ブログで知見を伝える と言う事を気負わずに書くコツとしては、 技術的知見をお裾分けする と言う位の気持ちで書いて行き、 自分のところではこう言う事に対してこう対処しました。何かの役に立つと良いですね！ と言うぐらいの気持ちでやっていた方が楽です。 そのため、
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
雑に思考を整理する技術と効能
テクニカルライティングの基本 2023年版
NotionAI のクリエイティブな活用事例37選｜ChatGPT研究所
技術をわかりやすく伝えるためテクニカルライティング
良質な技術記事を量産する秘訣 / #MeetsPro
DeepL Write: AI-powered writing companion
