[GitHub] [apisix-website] juzhiyuan commented on issue #964: [Site]: Why the website have to rebuild everyday?

[GitBox <gi...@apache.org>]

juzhiyuan commented on issue #964:
URL: https://github.com/apache/apisix-website/issues/964#issuecomment-1074624298


   This is a historical question that we discussed many times in 2020: do we need to put all project documentation in the apisix-website repository, or do we maintain each repository separately? The conclusion was to maintain each repository separately but keep a unified directory structure, that's why we will notice some directories like `{repo}/docs/{language}/xxx`.
   
   Under the current directory structure, the documentation website needs to fetch the original document content from each repository and build it. To ensure that the documentation station is up to date, a daily build is chosen, that's why we have a CRON job: https://github.com/apache/apisix-website/blob/master/.github/workflows/deploy.yml#L14
   
   Now that there is more and more documentation content in each repository, it is possible to build only the last few versions, and historical documentation can be archived to Netlify's service, refer to Docusaurus https://docusaurus.io/docs.
   
   ![image](https://user-images.githubusercontent.com/2106987/159391526-8ff3daf6-7f2e-4aff-b83c-2c3de7a344fb.png)


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org