Search results

mruby/cがmodule機能を（限定的に）実装したのでドキュメントの仕組みもmoduleに対応しなきゃならない！

Status: Open.

#19 In picoruby/picoruby.github.io;

· hasumikin opened on Aug 28, 2024

ドキュメント内の静的コンテンツとして関連記事へのリンクとかコラムを新たに書くとかもやっていけたらよさそう

Status: Open.

#16 In picoruby/picoruby.github.io;

· hasumikin opened on Mar 10, 2024

この自動生成の仕組みに汎用性を持たせてgem化する。jekyll pluginでもよいかも。このためにはPicoRubyには（いまのところは）ないmoduleにも対応する必要がある。PicoRubyにもmodule機能が入るかもしれないので、やっておくとよさそうではある

Status: Open.

#15 In picoruby/picoruby.github.io;

· hasumikin opened on Mar 10, 2024

RBSにはオプショナル引数のデフォルト値の情報が含まれない。たとえばrbファイルではdef m(a=0)となっている場合に、rgsではdef m: (?Integer a)となっていて、aのデフォルト値が0であることがわからない。デフォルト値をドキュメント化したいので、いいやり方がないか考えたい（コメントに書くとかでもいい思うが、rb実装との二重管理になってしまうから、rb実装ファイルから自動的に持ってこられるとありがたい）

Status: Open.

#14 In picoruby/picoruby.github.io;

· hasumikin opened on Mar 10, 2024

GitHub Action：picoruby/picoruby（masterブランチ）へのプッシュ時にrbsファイルが変更されていたらpicoruby/picoruby.github.ioを自動で更新するようにしたい

Status: Open.

#13 In picoruby/picoruby.github.io;

· hasumikin opened on Mar 10, 2024

privateメソッドは現状ドキュメンテーションに含めていないが、privateセクションを設けて載せるようにしてもいいかもしれない。ただし@ignoreが注釈されていたら載せない

Status: Open.

#12 In picoruby/picoruby.github.io;

· hasumikin opened on Mar 10, 2024

定数もドキュメント化したい

Status: Open.

#11 In picoruby/picoruby.github.io;

· hasumikin opened on Mar 10, 2024

いまは（画像参照）member[:souce]（(Integer) -> 0みたいな素のテキスト）を生成ドキュメントにそのまんま使用しているが、member[:required_positionals]以下の情報（現在は未使用）を組み合わせてドキュメントを生成するようにしたい。これができると、たとえばIntegerという型名からInteger.htmlへリンクできるのではないかと思っている。type_aliasも同様にリンクしたい

Status: Open.

#10 In picoruby/picoruby.github.io;

· hasumikin opened on Mar 10, 2024

継承（superクラス）についての情報を載せたい

Status: Open.

#9 In picoruby/picoruby.github.io;

· hasumikin opened on Mar 10, 2024

あわせて、picoruby/mrbgems/picoruby-mrubyc/sig/*.rbs（つまりPicoRubyコアライブラリの型情報）の多くは、rbs gemがもっているCRubyコアの型ファイルをコピってきてsteep checkが通るだけの状態へ雑に編集しただけのもの。パクってきたときにいっしょについてきた元々のコメントには解説文（riで読めるやつ）がくっついているので、これの記法も整合性をとる必要あり

Status: Open.

#8 In picoruby/picoruby.github.io;

· hasumikin opened on Mar 10, 2024

rbsファイル内のclass定義やメソッド定義にマークダウン（？）でコメント（用例など）を書くと、それがドキュメントにも載るようにしたい。注意点としては、すでにコメント部分には機能があって、@sidebar @added_by @ignoreという注釈がmd生成に影響を与えているので、そことの整合性を設計する必要あり

Status: Open.

#7 In picoruby/picoruby.github.io;

· hasumikin opened on Mar 10, 2024

tagsの機能がうまく動いていない（たとえば https://picoruby.github.io/tag_introduction.html が404）

Status: Open.

#6 In picoruby/picoruby.github.io;

· hasumikin opened on Mar 10, 2024