Skip to content

Commit 900e7cc

Browse files
znzclaude
andcommitted
docs: address review feedback
- Communication: ruby-jp Slack's #rurema channel is the main chat now; note that the Gitter room remains but is mostly unused - Module-function notation: the old '.#' typemark corresponds to '?.' (dot included), not just '?' -- fix the explanations in the FAQ, format digest, and method entry guide - Drop references to mise.toml, which does not exist in this repository (a recent single Ruby is enough for building) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1 parent 1275221 commit 900e7cc

6 files changed

Lines changed: 17 additions & 11 deletions

docs/Communication-and-knowledge-sharing.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,15 @@
22

33
るりまに関するコミュニケーション、情報共有をする場についてまとめます。
44

5+
## ruby-jp Slack
6+
7+
[ruby-jp Slack](https://ruby-jp.github.io/)**#rurema チャンネル**が、
8+
現在のメインのチャットの場です。雑な相談、Issue にするまでもない質問などはこちらへ。
9+
510
## GitHub
611

7-
議論・相談は基本的に [rurema/doctree](https://github.com/rurema/doctree)
8-
Issue / Pull Request で行います
12+
議論・相談は [rurema/doctree](https://github.com/rurema/doctree)
13+
Issue / Pull Request でも行います
914
ルール、ガイドラインなど内容の固まったものは、この `docs/` ディレクトリに集約します
1015
(旧 GitHub wiki は 2026年7月に `docs/` へ移行しました)。
1116

@@ -23,4 +28,5 @@ https://rurema.esa.io/
2328

2429
https://gitter.im/rurema-dev/Lobby
2530

26-
* 雑な相談をする場。Issue にするまでもない質問など
31+
* 過去にチャットの場として使われていました。ルームは残っていますが、
32+
現在はほとんど使われていません(上記の ruby-jp Slack を使ってください)

docs/FrequentlyAskedQuestions.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -34,14 +34,14 @@
3434
ソースコードの、autoload が書いてある場所に require が書いてあるものと
3535
考えてください。[[ruby-reference-manual:253](http://www.fdiary.net/ml/ruby-reference-manual/msg/253)]
3636

37-
### 「.#」や「?」ってなに?
37+
### 「.#」や「?.」ってなに?
3838

3939
[[ruby-reference-manual:143](http://www.fdiary.net/ml/ruby-reference-manual/msg/143)]
4040

4141
モジュール関数(クラスメソッドとしてもインスタンスメソッドとしても呼べるメソッド)を
4242
表す記号です。旧記法(RRD)では「.#」を使って「CLASSNAME.#METHODNAME」と表記して
43-
いましたが、Markdown 記法では RBS の `self?` に由来する「?」を使って
44-
`CLASSNAME?.METHODNAME` と表記します
43+
いましたが、Markdown 記法では「?.」を使って `CLASSNAME?.METHODNAME` と表記します
44+
`?` は RBS の `self?` に由来します)
4545
また、BitClust だとモジュール関数は c.singleton_methods と
4646
c.instance_methods の両方に出てくるので、ri との diff を取ると
4747
BitClust のほうがエントリがすげー多く見えたりします。
@@ -50,7 +50,7 @@ BitClust のほうがエントリがすげー多く見えたりします。
5050

5151
[[ruby-reference-manual:409](http://www.fdiary.net/ml/ruby-reference-manual/msg/409)]
5252

53-
どちらでもなく「?」を使って下さい。
53+
どちらでもなく「?.」を使って下さい。
5454

5555
例:
5656

docs/HowToJoin.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@
1919

2020
* Git と GitHub アカウント
2121
* Ruby — サンプルコードの検証やローカルビルドに使います。
22-
リポジトリの `mise.toml` が指定するバージョンで十分です
22+
最近の安定版が1つあれば十分です(複数バージョンを揃える必要はありません)
2323

2424
ドキュメント処理系の [BitClust](https://github.com/rurema/bitclust) は、
2525
doctree で `bundle install` すれば入ります。

docs/HowToWriteMethodEntry.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -192,7 +192,7 @@ ArgumentError, TypeError などは param で引数の条件がちゃんと書い
192192
[m:Kernel#puts]
193193
```
194194

195-
は間違いです。正しくは以下です(モジュール関数は `?` を使います)。
195+
は間違いです。正しくは以下です(モジュール関数は `?.` を使います)。
196196

197197
```markdown
198198
[m:Kernel?.puts]

docs/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -120,7 +120,7 @@ wiki 取り込み時の全40ページの棚卸しの記録です。**表の処
120120
| [License](License.md) | 部分更新 | リンク2行。`refm/doc/license.rd``manual/doc/license.md` に更新 |
121121
| SitePolicy | 削除 ✅ | wiki の編集権限ポリシー。リポジトリ移行後は PR ベースになるため不要 |
122122
| [ThirdPartyTools](ThirdPartyTools.md) | 維持 | 外部ツール事例集。リンク切れ確認は任意(rurema-search の行はサービス終了を反映) |
123-
| HowToInstallRubys | 削除 ✅ | 複数 Ruby の環境構築(2017年、rbenv/古い Windows 前提)。現在は外部資料が充実しており、本リポジトリの検証環境も mise.toml で完結 |
123+
| HowToInstallRubys | 削除 ✅ | 複数 Ruby の環境構築(2017年、rbenv/古い Windows 前提)。現在は外部資料が充実しており、ビルドも最近の Ruby が1つあれば足りる |
124124
| HowToInstallRubysUnixRbenv | 削除 ✅ | 同上 |
125125
| HowToInstallRubysWindows | 削除 ✅ | 同上 |
126126

docs/ReferenceManualFormatDigest.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -81,7 +81,7 @@ Ruby のクラスやメソッドなどへは以下のようにリンクを書き
8181
|-----|-----|
8282
|クラス|`[c:String]``[c:File::Stat]` など|
8383
|クラスメソッド|`[m:String.new]`|
84-
|モジュール関数|`[m:Kernel?.open]`(旧記法の「`.#`」は「`?`」に変わりました)|
84+
|モジュール関数|`[m:Kernel?.open]`(旧記法の「`.#`」は「`?.`」に変わりました)|
8585
|インスタンスメソッド|`[m:String#dump]` など|
8686
|`[]` を含むメソッド|`[m:String#\[\]]`(バックスラッシュでエスケープ)|
8787
|定数|`[m:File::SEPARATOR]` など|

0 commit comments

Comments
 (0)