Automate release and documentation upload

[Xanthorapedia]

Summary

We would like a mechanism for automatically updating pypose.org/docs that:

1. Centralizes artifact building (downloads built artifacts from CircleCI instead of building again as in the current workflow.
2. Pulls the latest release version and upload it to pypose/pypose.github.io/docs.
3. Updates pypose/pypose.github.io/docs/versions.html to reflect the newly added doc.

Improvements

More consistent artifact building. No need to manually upload and update docs page.

Risks

No known risks.

Involved components

.github/workflows/python-publish.yml
.circleci/config.yml

[zitongzhan]

Maybe take a look at mmdet. They implemented similar mechanisms.

[wang-chen]

@zitongzhan Just checked mmdet, they have a similar doc template, but it seems that they don't implement the auto doc versioning. We want something like this: https://pypose.org/docs/versions.html
The current doc v0.2.2 was uploaded manually but we want to make it automatic when new versions are released via this action. Please correct me if I am wrong.

[zitongzhan]

@zitongzhan Just checked mmdet, they have a similar doc template, but it seems that they don't implement the auto doc versioning. We want something like this: https://pypose.org/docs/versions.html
The current doc v0.2.2 was uploaded manually but we want to make it automatic when new versions are released via this action. Please correct me if I am wrong.

I thought they had that since their document version always synchronize with package release. I will take a closer look on this.

[wang-chen]

oh yes, I didn't notice that they put the versioning in the left bottom corner. Thank you!

[zitongzhan]

I found out that the version inside mmdet's document is not part of their compiled html. Instead, it is manage by this service.