Merge pull request #3040 from znz/docs/triage-content

docs: rewrite and refresh the imported wiki pages for the Markdown era

Author: znz

CONTRIBUTING.md

@@ -44,6 +44,24 @@ $ bundle exec rake generate:3.4    # BitClust データベース生成
 $ bundle exec rake statichtml:3.4  # 静的 HTML 生成
 ```
 
+手を動かしながらの詳しい手順は [docs/Tutorial.md](docs/Tutorial.md) を、
+プロジェクト文書の一覧は [docs/](docs/) を参照してください。
+
+## いろいろな貢献のかたち
+
+ドキュメントの編集以外にも、次のような貢献を歓迎しています。
+資格は特に必要ありません。日本語が扱えると助かります。
+Ruby でプログラミングができるとサンプルの検証などもできて便利ですが、必須ではありません。
+
+* ドキュメントの誤りの指摘（バージョン間違いなど） —
+  [Issue](https://github.com/rurema/doctree/issues/new) を登録してください。
+  最新版で修正済みかどうかを先に確認してもらえると助かります。
+  修正内容がわかっている場合は Pull Request にしていただけると適用が楽になります
+* ドキュメントをよりよくするための提案（説明文の追加など）
+* サンプルコードの提供
+* 既に上がっている Issue へのコメント
+* ブログや勉強会などで「るりま」を紹介する
+
 ## 各バージョンの対応方針
 
 以下の方針で対応します。

docs/CapiReferenceManual.md

@@ -1,19 +1,31 @@
+# C API リファレンス
+
 <dl>
 <dt>名前</dt>
 <dd>C API リファレンス</dd>
 <dt>URL</dt>
 <dd><a href="https://docs.ruby-lang.org/ja/latest/function/index.html">https://docs.ruby-lang.org/ja/latest/function/index.html</a></dd>
-<dt>代替 URL</dt>
-<dd><a href="http://doc.okkez.net/193/view/function/">http://doc.okkez.net/193/view/function/</a></dd>
+<dt>ソース</dt>
+<dd><code>manual/capi/*.md</code>（1ファイル = Ruby の1ソースファイル。例: <code>array.c.md</code>）</dd>
 <dt>概要</dt>
 <dd>
 C API リファレンスは、拡張ライブラリや組み込み Ruby で用いる
 C 言語の API (関数やマクロ) を記述したリファレンスです。
 </dd>
 </dl>
 
+書式はクラスリファレンスとほぼ共通ですが、シグネチャの H3 に
+`def` などのキーワードを付けません（C のシグネチャは型から始まるため）。
+
+```markdown
+### VALUE rb_ary_new()
+
+空の Ruby の配列を作成し返します。
+```
+
+詳細は [MARKUP_SPEC.md](https://github.com/rurema/bitclust/blob/master/doc/markdown-samples/MARKUP_SPEC.md) の「C API リファレンス」の節を参照してください。
+
 ## 関連
 
-* [[ProjectTimeLine]]
-* [[ToDo]]
-* [[BitClust]]
+* [ProjectTimeLine](archive/ProjectTimeLine.md)（歴史的経緯）
+* [BitClust の使い方](https://github.com/rurema/bitclust/blob/master/doc/usage.md)