tuteng commented 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 developers 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: [email protected] With regards, Apache Git Services
