For some time now we’ve been trying to figure out a way to render Mattermost documentation so that it:
- Supports export to PDF
- Supports localization
- Supports includes (e.g. write the SMTP install instructions once and include it in all install guides without copy and pasting everywhere).
- Doesn’t require us to mangle our folders and naming conventions
- Supports table of contents
- Supports search
Right now, no matter how hard to try to find a markdown solution, it seems Sphinx is the only framework that supports what we need.
Any suggestions from the community?