Hacker News new | ask | show | jobs
by steveklabnik 685 days ago
Both public and tailor-made: https://github.com/rust-lang/book/tree/main/tools
2 comments

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!

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!

Awesome! You and Carol rock!
Thanks! She gets 100% of the credit in this case though :)