sway icon indicating copy to clipboard operation
sway copied to clipboard

Published 20 hours ago • verified publisher icon FuelLabs

mdbook-forc-documenter needs a more sophisticated way of handling nested sections

Open kayagokalp opened this issue 3 years ago • 1 comments

With #2440, we needed to document with the following structure:

...
- 11.4. Plugins
  - 11.4.1 forc client
    - 11.4.1.1 forc deploy
    - 11.4.1.2 forc run
  - 11.4.2 forc explore

But mdbook-forc-documenter does not support this kind of nesting. Related to https://github.com/FuelLabs/sway/pull/2440#discussion_r936602561 and https://github.com/FuelLabs/sway/pull/2440#discussion_r936745062

I introduced some intermediate implementations to create the structure above at that PR but it only supports a single level of nesting. We may need to have a graph-like structure to hold this nesting information.

kayagokalp avatar Aug 03 '22 16:08 kayagokalp

I think the intermediate implementations are close enough but could just use a little tweaking for readability - see this comment.

mitchmindtree avatar Aug 11 '22 06:08 mitchmindtree

I don't think this should be necessary, I'm happy for us to draw the line at one level of nesting. I think all we're after is a way for a single plugin crate to support more than one command.

I think this is completed/not-planned as the linked comment is addressed and further enhancements are not needed. Feel free to re-open it otherwise. Closed by #2440 as a side effect

kayagokalp avatar Aug 18 '22 12:08 kayagokalp