前に書いた技術記事を久しぶりに読み返してたんだけど、公式ドキュメントへのリンクがいくつか移転先サイトのトップページに飛ばされてて、本文の説明と全然噛み合わなくなってた。404 ならリンクチェッカーで気付けるけど、リダイレクトでトップに着地するやつはステータスが 200 で返ってくるからすり抜けるんだよね。最近はリンク先のページタイトルも並べて目で確認するようにしてる。 #技術記事 #個人開発 #エンジニア #生産性

技術記事に貼るターミナルのスクショ、コードの中身だけ気にして撮ってたんだけど、公開前に1枚ずつ拡大して見直したら6枚中4枚でプロンプトにホームディレクトリのユーザー名が写り込んでた。本文のコードはちゃんと伏せてたのに画像のほうは完全にノーチェックで、最近は撮る前にプロンプトを短い表示に切り替えてから撮るようにしてる🔍 #技術記事 #個人開発 #エンジニア #生産性

Qiitaの記事を書き終えたあと、公開前に「この記事を一文で言うと?」って自分で書いてみるようにしてるんだけど、この前どうしても一文に収まらなくて、よく見たら設定の話と運用の話の2つが混ざってた。思い切って2本に分けたら4,000字が2,200字と1,900字になって、どっちも最後まで読みやすくなった気がする。一文で言えないときは、だいたい記事が2本分ある。 #技術記事 #Qiita #個人開発 #エンジニア

最近Zennに書いた記事を公開から半年くらい経ってから見返してたんだけど、読まれ続けてるのは時間をかけた解説記事じゃなくて、エラーメッセージを原文のままタイトルに入れた短いトラブルシュート記事だった。たぶん検索窓にそのまま貼られてるんだろうなと思って、それ以来ハマったときは出たエラー文を一字も変えずに見出しに置くようにしてる。きれいに言い換えるほど見つけてもらえなくなるの、ちょっと皮肉だなと思った。 #Zenn #技術記事 #個人開発 #エンジニア

技術記事の書き出し、前は「なぜこれを書くのか」の背景を3段落くらい置いてから本題に入ってたんだけど、下書きをAIに読ませて「読者が最初に手を動かせる行はどこ?」って聞いたら7段落目って返ってきて、ちょっと驚いた。試しに背景を1段落に削って手順から始めたら文字数は2割減ったのに、読み返しても削りたい箇所が一つもなくて、冒頭の背景って読者じゃなくて自分を納得させるために書いてたんだなと思った。 #技術記事 #ライティング #個人開発 #アウトプット

技術記事のタイトル、最後にAIへ「案を10個」って頼んで選んでたんだけど、並べてみると8個くらいが「〜する方法」「〜のすすめ」の型で、どれを選んでも本文より薄く見えるのが気になってた。最近は先に本文から一番具体的な一文を抜き出して、それを短く削る方向にしてて、あとで読み返しても自分で中身を思い出せるタイトルになった。案を増やすより本文から拾う方が早かった。 #技術記事 #ライティング #個人開発 #アウトプット