自己流の手順書フォーマットを公開してみた | DevelopersIO

手順書フォーマットは千差万別 みなさんは自己流または、組織やプロジェクトで定められた手順書のフォーマットはありますか? 私は自己流の手順書フォーマットがあります。 自己流の手順書フォーマットがあるといっても、かなり扱いがふわふわしているので、備忘やメモの意味合い強めでまとめていきます。 「もっとこうした方がいいよ!!」などフィードバックがあれば、ぜひお願いします! いきなりまとめ 手順書はExcelやスプレッドシートではなく、Markdownで書く 手順書はgitで管理する 5W1Hを意識して手順書を書く 基本的にはCLIを使った手順書にする 手順書はExcelやスプレッドシートではなく、Markdownで書く 手順書をExcelやスプレッドシートで書くメリット・デメリット 手順書をExcelやスプレッドシートで書いている方も多いと思いますが、私はMarkdownで書いています。 Exce

[carbon00]

Markdownはさ、確かに理想的だしそれで済むならそうあるべきだとも思うんだけど。図が、画像が、どうしても扱いづらいんだよ。そして紙に出してしまうと途端に崩れるんだ。巡り巡って俺はWordに戻ったよ。笑えよ。

[manFromTomorrow]

わかる、一度はmd化するんだよ。でも結局Excelに戻るんだよ…

[KAZ99K]

One Note派の人です。簡単に画像貼れるし単一文書じゃなく束で纏めれるしリンクできるしチームで編集できるし誰がいつ書いた消したが文字単位で履歴つくしPDFに出来るしスマホで現場写真撮ってスマホで手順書作ってた

[kijtra]

これは顧客と共有する時に「見れない」と言われて結局ExcelやWordに戻る予感(経験者)w

[shimarisugi]

図が辛い方はdrawio使ってsvg形式で編集するのおすすめ。

[cl-gaku]

手順書は見るやつのレベル感選べんからExcelでしゃーない

[jacoby]

確かにMarkDownは図がつらい。PlantUML埋め込めるけど、配置が調整できないとかデフォルトの色のダサさとかいろいろと

[macority]

Markdownは図とか表が使いずらいのよね。むしろExcelはOneDrive置いとけば履歴管理されるし、校閲でコメント入れれたりデメリットが減ってる気がする

[digitalmatic]

印刷すること一生ないから参考になった

[carpediem78]

手順書

[lin2734]

有益感えぐい

[nabinno]

現場毎に異なるので一概に正解とは言えませんがesaを使えるなら、バージョン管理も含めて一元管理できるのでお薦めです。PlantUMLもきれいに描けます。

[hase0831]

これは良い

[craftone]

自分用とか仲間内のメモ的なのはmarkdownだけど、それなりに長かったり公開したりする手順書はWordで、商用作業手順書はExcelだなぁ。用途によって変えざるを得ない。One fit all なものは無いのか？

[yoshi-na]

手順書はすべてDropbox Paperで書くようにしている、共有も更新も楽なのでオススメ（フリーランス）

[inoyy]

Markdown

[mysql8]

歩く手順書

[negima1976]

なんやかんやでスプレッドシートに着地する

[ten-gallon-Mouse]

手順書はMarkDownで書いて、GITで管理し、HTMLでリリースする。

[okinaka]

kibera だと markdown でプレビューや履歴も管理できて、画像貼り付けも楽だから割と便利 (ただし有料）

[rokuzeudon]

👀

[narita1980]

これはすごい参考になった！

[sharp_m]

スクショを貼りまくるのでWordになっちゃう

[kiyo_hiko]

Markdownでドキュメント出したプロジェクトでお客さんから何度も文書のクオリティが糞だと貶される→Excel方眼紙万歳になった虎馬がありmd怖い。どうしてもスカスカに見える。例えばTeX等ならマシか、そうでもないのかな

[kai_kou]

すばらし

[kuwayoshi]

mdがーという人は、typoraとかmarktextとか、書きやすいmdエディタ探すのがおすすめ

[hdampty7]

あああ、自分もMD派だったけど、同じ不便を経験した人多すぎ。ここ、絶対、狙い目なので誰か若い人頑張れ！

[roppara]

紙で出力する場合はexcelよりもPowerPointで作りたくなる。 excelだとプリンターが変わると改行位置が変わるケースがあって修正が大変だったんや…

[massox]

手順書のフォーマットの話があまりない気がする。VSCodeの拡張の使い方は本題じゃないので、あまり無い方が読みやすそう。

[showii]

ほとんど同じ。しかしテーブル表がつらいのがmdのマイナス点。

[Shinwiki]

現実を知る者たちの宴がここに

[programmablekinoko]

OneNote好きだけどコードブロックがどうも駄目、コード中心だとマークダウン最強はわかる。図が多いものはOneNoteとかWYSYWIGエディタを素直に使うことにしている。だがWeb版のIMEとの相性が最悪なのはいかんともしがたい

[yasu-log]

【B!】自己流の手順書フォーマットを公開してみた | DevelopersIO

[Makots]

仕事でNotion使えるとハッピーになれるのになぁ

[tyuke]

Excelの問題はデータシートとして扱いにくいとかではなくて、読みにくいことだと思ってる。字幅とか行間とかシートの見落としがあるとか。しっかり視認性を確保してほしい。