このサイトについて
複雑なシステムのドキュメントやマニュアルを書いているうちにヘルプシステムもできてしまうのを目指す
複雑なシステムの例としてGitを使う
Gitの使い方を書くのと同時に、便利なgithubコマンドができる
文芸的プログラミング的
Gitの使い方をScrapboxに記述しつつ、GitHelpコマンドで使うためのデータも書いておく
例えばファイルの編集回数のランキングのページに 以下のようなデータを書いておくとgithelpコマンドで使える
$ (よく|頻繁に)(編集|修正)されているファイルを(リスト|表示)する
% git log --name-only --pretty="format:" | grep -ve "^$" | sort | uniq -c | sort -r
人間がわかる表現を正規表現で$ xxx ... と書く
その実行コマンドを% git ...と書く
ユーザが「頻繁」とか入力するとこの説明が出て、すぐ実行できる
% githelp 頻繁
関数やマクロもScrapboxで定義する
コード記法で書いておく
args とか Glossary とか
目標: UIST2018投稿
招待リンク