0xMiden / 0xMiden/protocol

Automate doc build for `miden` library

Aperta
#1,839 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub
documentation standards
Lingua principale
Rust
Stelle
132
Fork
167
Merge medio
1g 23h
PR unite (30g)
110

Descrizione

Following the idea/approach from https://github.com/0xMiden/miden-vm/pull/2105, we should come up with a way to build docs for the `miden` protocol library automatically. It would probably result in one doc page per module, e.g. `miden::account`, `miden::tx`, etc. rather than the one page introduced in https://github.com/0xMiden/miden-base/pull/1799, but that's fine and may even be cleaner.

Two challenges here for `miden` protocol lib specifically are:
- We have a `Context` column which we either need to maintain manually or derive from the doc comments of the procedures. Deriving it from the doc comments seems best, so it's easier to maintain the correct context when reviewing code.
- Some doc comments added in https://github.com/0xMiden/miden-base/pull/1799 link to other doc pages, e.g. to explain what _recipient_ or note _metadata_ refers to. It would be ideal to keep them. Most likely, this means we should add markdown links to the MASM doc comments directly, but maybe there are other approaches.

Context: https://github.com/0xMiden/miden-base/pull/1799#pullrequestreview-3170809545

Guida per i contributori

Apri la guida per i contributori

Valutazione

Questa issue non è ancora stata valutata.

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.