私の技術記事の書き方 - azukiazusaのブログ
技術記事を書くことは、最初はなかなかハードルの高い作業に思えます。文章を書くにはある程度の慣れが必要である考えています。 誰しも初めのうちはうまく文章を書くことができず、文章を書く訓練を重ねることで、内容を伝えやすい・理解しやすいある種の「型」を発見されているのではないかと思っています。 この記事では id:azukiazusa が普段記事を書く時に考えていることを書き下していきます。 見出しを先に書く コードは実行可能にする 文法エラーがないように 文脈依存にならないように foo や bar のような名前を使いすぎない 記事は1日寝かせる その他文法的な事項 見出しは ## から始める インラインコードブロックは装飾目的で使わない 英語と日本語の間に半角スペースを空ける おわりに 参考 見出しを先に書く 私が技術記事を書くときには最初に見出しから書き始めます。下記のような感じです。 見
2022 年のアウトプットを振り返る - azukiazusaのブログ
ブログ 今年も毎週書いた。毎週更新は3年くらい(?)継続してるはず。 azukiazusa.dev Zenn 月に1本くらいのペースで書いてる。40万字って書いてはあるけどコード書くと文字数盛れがちなので実態はも少し少ないはず。 1番閲覧数が多い記事が意外だった。いいね数順に閲覧数が増えるわけでもないらしい。 人気があった記事 zenn.dev MSW を使うとモックがより低レイヤーになっていいよねという話。 zenn.dev 話題性⭕️ zenn.dev zenn.dev zenn.dev 丁寧なチュートリアル。 zenn.dev 図が書いてあって偉い。パターン化しておくと覚えやすいね。 来年の抱負 記事中の画像に alt 属性を付けていこう。
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
