[GitHub] [pulsar] tuteng edited a comment on issue #5609: [Doc] Remove duplicate pages

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

tuteng edited a comment on issue #5609: [Doc] Remove duplicate pages
URL: https://github.com/apache/pulsar/pull/5609#issuecomment-557754827
 
 
   > I don't understand #5700 at all; it says it's being done because of limitations of docusaurus, which is a platform I don't know.
   
   Docusaurus is a framework with version management of documents https://docusaurus.io/docs/en/installation.
   The sub-version depends on the main version. Observe the following `id` and `original_id` fields. If the main version file is deleted, the file under the subversion will not find the index. Users get a lot of Http 404 when viewing older versions of documents. However, if we don't delete the files and keep the contents under the main version, there will be many duplicate contents, which will lead to confusion when the contributors contribute. therefore, we delete the contents and only keep one header in order for the sub-version to have a correct index, the contributor only needs to update the contents in the main version.
   @candlerb 
   
   `functions-api.md`
   main version (latest version)
   ```
   ---
   id: functions-api
   title: The Pulsar Functions API
   sidebar_label: API
   ---
   ```
   Subversion, (old version)
   ```
   ---
   id: version-2.4.0-functions-api
   title: The Pulsar Functions API
   sidebar_label: API
   original_id: functions-api
   ---
   ```

----------------------------------------------------------------
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.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services