> Just put them in the website repository? Actually, I would prefer discussing on if we'd better lead users to use the Website instead of GitHub markdown files, or keep the current status (LGTM now).
If ok, we could involve Docusaurus's most features with our docs, though it will reduce the readability of reading markdown files. Here have 2 examples: [1][2] [1] https://docusaurus.io/docs/installation [2] https://docusaurus.io/showcase Best Regards! @ Zhiyuan Ju <https://github.com/juzhiyuan> Chao Zhang <[email protected]> 于2021年11月19日周五 上午9:34写道： > Hi, there > > I’m not familiar with the website maintainment and design, so if we drop > the support of docs on GitHub, where should we put these document > materials? Just put them in the website repository? > > Chao Zhang > https://github.com/tokers > > On November 18, 2021 at 14:18:43, Tsangleslie ( > [email protected]) wrote: > > 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] >
