Thanks! I’m less soliciting for people to use this specific solution and almost sharing aloud hoping someone will say “duh use crate X”
Thanks for the concern over votes. I think your comment turned the tides, I’m at +1 now.
Overall Rust has the best doc eco system of any lang I’ve used. I wish more communities stole from rust. The most useful part of any doc is an example and rustdoc makes it really easy to write one and keep it from doc-rotting. My particular pain is for an author who aims to go above and beyond.
Specifically I was thinking of the winnow tutorial when writing this crate. The return type example is straight from what I would like to be able to toggle on/off in their docs.
I also have a more mature library for easing maintenance burdens for tutorial writing but it’s not rust https://github.com/zombocom/rundoc
Comments
Thanks! I’m less soliciting for people to use this specific solution and almost sharing aloud hoping someone will say “duh use crate X”
Thanks for the concern over votes. I think your comment turned the tides, I’m at +1 now.
Overall Rust has the best doc eco system of any lang I’ve used. I wish more communities stole from rust. The most useful part of any doc is an example and rustdoc makes it really easy to write one and keep it from doc-rotting. My particular pain is for an author who aims to go above and beyond.
Specifically I was thinking of the winnow tutorial when writing this crate. The return type example is straight from what I would like to be able to toggle on/off in their docs.
I also have a more mature library for easing maintenance burdens for tutorial writing but it’s not rust https://github.com/zombocom/rundoc