GitHub Wiki を使って店舗の作業マニュアルを作成する

GitHub 今僕が担当しているポジションを複数のスタッフが手伝うないしは引き継ぐことになりそうなので、どんなことをどんな手順で教えるか考えているのですが、相手が経験のある人間というわけではなく、口で一度説明すればすぐ出来るような作業でもないので、少しドキュメントにまとめておきたいと考えました。そうなっていれば、業務中にちょっとした迷いがあった時でも参照することが出来ます。僕の時もそんなのがあったら楽だったんですが、あいにく飲食店にはそんなものありません。大手チェーンにはいわゆる「業務マニュアル」はあるかも知れないけど、まあそういうことじゃないです。なぜならみんな料理人たちの頭に入っているから…… ……と言いたいところですが、実際には単純にそういう文化ではないだけです。ドキュメントで(メモ書きでも良いけど)きちんと残すとということはあまりしません。そのおかげで「去年これどうしてたっけ」とか「前やったときはどんなだったっけ」とか、割と曖昧な記憶のまま、何人かで「多分こうなんじゃないか」と言って曖昧に進めていくことが多いです。それで上手く行ってるんだろうから別にそれがどうっていうわけじゃないですけど、僕自身が関わる部分についてはもうちょっとね。「記憶力」という個人差が大きく加齢に伴って減衰するような不確かな能力に頼るのではなく、誰が見ても同じように解釈できるドキュメントとして残しておきたいと思ったのでした。 というわけで、やってみた。

続きを読む

【メモ】gitコマンドも省入力

ノートパソコンと観葉植物 これつながりで。 【メモ】シェルスクリプトを省入力で実行する | mutter 打ち込む回数の多いgitコマンドも省入力にしてしまいたいなあと思っていたんですけど(前世の記憶で出来るような気がしてたけど思い出せなかった)、なるほどエイリアスを設定すれば良いんですね。 よく使うgitコマンドのエイリアスを設定して開発効率をアップする – Qiita

続きを読む

gistの埋め込みを入れると表示が崩れる件

17_02.jpg ブログにコードの一部だけを載せたいようなとき、githubのgistにアップしてその埋め込みをブログに貼るというのを良くやるのですけど、このところずっとその埋め込みの表示が崩れて難儀してました。 上の画像にあるとおり、

  • スクロールバーが2重に出てしまう
  • コードの一番上に隙間が出来る
  • 行番号とコードの行がずれる
といった感じに崩れてしまって、コードは読めるものの見栄えがよくない。とはいえ埋め込みってことは通常CSSの管理はサービス側の仕事だし、こっちでやれることはないんだろうな……と思ってたらそうでもなかった。これiframeじゃなくて生のHTMLタグを書き出してるんですね。そうだったのか。だからCSSをこちらで設定してやれば崩れるのを修正出来ると。

続きを読む