Ah, good to know! Is that tooling public anywhere, or was it pretty tailor-made just for the Rust book?
Re:Why I Prefer RST to Markdown
by steveklabnik on Wednesday July 31, 2024 @03:59PM
(#41122876)
Both public and tailor-made: https://github.com/rust-lang/book/tree/main/tools
Awesome! You and Carol rock!
Re:Why I Prefer RST to Markdown
by steveklabnik on Wednesday July 31, 2024 @04:46PM
(#41123265)
Thanks! She gets 100% of the credit in this case though :)
I can find here the process of converting docx to md, but not the reverse. I see the material is checked into the repo in both formats. Does that mean the docx's are your master, and you generate the markdown from it for diffing and building HTML?
I'm investigating how to switch an organisation away from a docx-only mess of a documentation system, and it looks like you might have found a process that'd work for us, and let people keep using docx if they have to.
I wonder what all those binary blobs do to the git repo though.
Thanks for any info!
Re:Why I Prefer RST to Markdown
by steveklabnik on Thursday August 01, 2024 @11:13AM
(#41130008)
You'd have to ask Carol, with the way we split the work, she handled all of this.
From my perspective, the markdown was the master copy.
Sorry I can't be of more help!
That doesn’t mean that I think Markdown is inadequate or the wrong decision, but it’s not just a “write in Markdown and you’re good” sort of situation.