More Related Content
Similar to エンジニアライクにドキュメントを作成してみた件 (20)
エンジニアライクにドキュメントを作成してみた件
- 10. 当初の私の気持ち
• 複数の編集者が都度更新をかけるなら、Gitでバージョン管理したい
• さらにいうと、Pull & Requestでレビューしたい
• Webで限定公開し、ここにいけば良いという場所を作りたい
• 最新のファイル、誰かおいてくれました?みたいな状況も防ぎたい=リリースを自動化したい
• HTMLやCSSで見栄えが良いほうが読み手のモチベーションも上がりそう
• さらにいうと、ビルドすれば手軽にHTMLに変換できるし、書き慣れたMarkdown使いたい
• 表記ゆれや単語の言い間違いは機械的にチェックしたい
• ただでさえ、業務の合間にする活動なので無駄な労力はかけたくない