add workflow to generate the docs and upload the docs

[xianshijing-lk]

this PR:

1. create a publish-docs.yml, that will create the docs, and upload to S3, it can be either manually triggered or triggered by make-release.yml
2. make-release.yml will trigger the publish-docs
3. updated some comments in some files

[xianshijing-lk]

I couldn't find a good way to test the docs job with this PR, I am going to land it to trigger the job.

[1egoman]

@xianshijing-lk Github actions is down as of my writing of this comment (see https://www.githubstatus.com/), so that might be why you are having trouble testing this.

That being said, if you wanted a way to test this, you could add a dry run flag like the aic plugin repo has (and then update downstream publish steps to respect it):

on:
  push:
    tags: [v*.*.*]
  workflow_dispatch:
    inputs:
      dry-run:
        description: Dry run (test workflow only)
        default: true
        type: boolean