protocolbuffers/protobuf

Ruby class documentation barely exists

オープン

#21,092 opened on 2025/04/04

 (6 件のコメント) (1 件のリアクション) (0 人の担当者)C++ (16,128 件のフォーク)batch import
documentationhelp wantedruby

Repository metrics

Stars
 (71,223 個のスター)
PR merge metrics
 (PR metrics pending)

説明

What language does this apply to? Ruby

Describe the problem you are trying to solve.

Currently, languages like Golang provide full documentation on fields and methods for Protobuf objects:

The Ruby documentation https://www.rubydoc.info/gems/google-protobuf is extremely bare-bones and doesn't include any of the C-generated methods - there isn't even an entry for the Message class.

Describe the solution you'd like

I can definitely help with generating documentation via YARD comments. YARD allows you to make "fake" methods so it shouldn't affect the C-generated methods. There are other options of course, but that might be the one with the least lift.

Is this something that the team would be interested in accepting?

コントリビューターガイド