What theme are you using with Docusaurus? The classic theme (default). I am curious what you are seeing that is Facebook-specific that you are cleaning up. Would love to hear the feedback. Thanks!
Gatsby is a great tool for documentation as well. In fact, some of our open source projects use Gatsby (e.g., reactjs.org). We feel that Docusaurus serves a bit of a different audience. Docusaurus is focused on the fastest way to document a project. We wanted to provide a really quick way to get a site running with certain core functionality that folks might find useful. We can see Gatsby and Docusaurus possibly collaborating on some features. In fact, we could see integrating/adopting parts of Gatsby into Docusaurus under the hood. That is something that is worth exploring moving forward.
Hi @eitland! We wanted to start off relatively simply for the launch. Support for markdown and static assets, including images, css, raw HTML, etc.
However, we are definitely looking at supporting other formats moving forward. We just want to make sure we do not complicate Docusaurus too much by doing so. Trying to find a good balance.
Thanks @EricVicenti! And congrats to you as well, especially since you were the one who brought this idea to us back in the summer. So happy you did. :)
In my mind, there will be multiple renderings of the spec (like what you had done here). I have plans to split the spec into multiple, smaller .md files based on topic. The gating factor was managing the internal reference links, but I can work around that with some tooling. I did not want this to hold up getting the spec out there though.