You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@pulsar.apache.org by GitBox <gi...@apache.org> on 2022/06/28 02:32:36 UTC
[GitHub] [pulsar-site] michaeljmarshall opened a new pull request, #123: Cleanup asf site next
michaeljmarshall opened a new pull request, #123:
URL: https://github.com/apache/pulsar-site/pull/123
## Motivation
The current docs are generated in an additive process where we build from the `main` branch and then copy the result to the `asf-site-next` branch. That means incorrect files are left in the `asf-site-next` branch. The only way to remove branches is manually right now. This PR removes pages that should not be on the website.
Note that this PR partially solves the problem described in https://github.com/apache/pulsar/issues/15984. It does not solve the underlying problem, but it at least makes the python docs discoverable without needing to know where they are.
## Changes
* Remove several versions of Python docs that are `-SNAPSHOT` docs. These directories have corresponding directories that supersede these `-SNAPSHOT` docs.
* Remove the python docs in the `content/api/python/` directory. The consequence of this change is that this page https://pulsar.apache.org/api/python/ will stop rendering old python docs and will instead render all python doc versions. We should probably fix that experience, but at the very least, this change will fix the underlying problem of having docs that are unreachable.
--
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: dev-unsubscribe@pulsar.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [pulsar-site] michaeljmarshall merged pull request #123: Remove old Python Client docs
Posted by GitBox <gi...@apache.org>.
michaeljmarshall merged PR #123:
URL: https://github.com/apache/pulsar-site/pull/123
--
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: dev-unsubscribe@pulsar.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [pulsar-site] michaeljmarshall commented on pull request #123: Remove old Python Client docs
Posted by GitBox <gi...@apache.org>.
michaeljmarshall commented on PR #123:
URL: https://github.com/apache/pulsar-site/pull/123#issuecomment-1168156455
Confirming the change had the desired affect. This link https://pulsar.apache.org/api/python/ is now:
<img width="604" alt="Screen Shot 2022-06-27 at 9 50 28 PM" src="https://user-images.githubusercontent.com/47911938/176081404-57bd9d06-8840-47f0-8a4e-6fba811085af.png">
Like I said, we'll probably want to fix the format, but I would rather have something that works for each specific version of the python client than an incorrect doc that isn't for any released version of the python client.
--
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: dev-unsubscribe@pulsar.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org