Automate doc build for `miden` library
- 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.