Hi Baoyuan, Tsangleslie means GitHub doesn’t support some features Docusaurus have, like MDX and Heading IDs.
Actually, we have talked this long ago, at that time, our website and documentation site are still under development. Today, we have the main reasons to improve Developer’s experience is: how to well structured Docs? How to make it simple and clearer enough for our newcomers? For Tsangleslie’s questions, I’m my opinion, we don’t have to migrate all docs from repo to website directly, maybe we could start using Docusaurus’s features and leading developers to use Doc site more often? It needs to take a long time to gradually migrate and improve docs from contents to others points :) Baoyuan <[email protected]>于2021年11月18日 周四下午2:33写道： > Hi Leslie Tsang, the documentation on the official website is automatically > generated from the project's Github doc directory; see apisix-website[1]. > > [1] https://github.com/apache/apisix-website > > > Tsangleslie <[email protected]> 于2021年11月18日周四 下午2:18写道： > > > Hi community, > > Currently, Apache APISIX project documentation need to take of > > both GitHub and official website versions, which cause a lot of special > > design and large differences in reading experience, I propose to cancel > the > > maintenance of GitHub version to ensure maintainer’s time can be used > most > > efficiently on the official website version. > > > > Here is the point why we should cancel the GitHub version: > > - Better i18n support for documentation, ref to APISIX issue > > #5392[1] > > - Better markdown support for unofficial feature, since GitHub > > markdown doesn't support them > > - More traffic view on APISIX Website, which would also help > > people understand what is happening in the community > > > > Please let me know if you have any suggestions, improvements, > > modifications. > > > > [1] https://github.com/apache/apisix/pull/5392 < > > https://github.com/apache/apisix/pull/5392> > > > > Leslie Tsang > > [email protected] > > > > > -- 来自 琚致远
