[Build] Build and publish api doc

[hughperkins]

Issue: #

Brief Summary

Doc for each branch is published to:

https://ideal-adventure-2n6lpyw.pages.github.io/[branch-name]/taichi.html

For example, this branch is hp/doc, so the docs are at:

• https://ideal-adventure-2n6lpyw.pages.github.io/hp/pdoc/taichi.html

Note taht this pr depends on hp/manylinux. branch, so probably best to approve/merge that PR first :)

copilot:summary

Walkthrough

copilot:walkthrough

[hughperkins]

@duburcqa So without contents write, this fails:

https://github.com/genesis-company/taichi/actions/runs/16028004337/job/45224022646?pr=46

(PS I wish github would warn me, when I try to paste a comment, and screenshot didnt upload yet... 😓 )

[duburcqa]

Maybe it is because this is a private organization? Another weird behavior I don’t quite understand…

[hughperkins]

Maybe it is because this is a private organization? Another weird behavior I don’t quite understand…

URL for where you are using workflow_call, along with secrets in the child call? (My understanding is this is somehow related to their security model, rather than to public/private 🤔)

[hughperkins]

(happy to create a new public repo, in my personal github, and we can try different things there too, to compare)

[duburcqa]

Ok now I understand, I think many of the weird quirks we are seeing here seem to be related to using workflow_call, which makes your workflow "reusable". Did you do this on purpose? If so, could you explain me what it is supposed to do?

After checking the documentation very quickly, this at least explain the issue with explicitly specifying the secrets that are required. I guess it is the same for the write permission. For the weird URL, it is probably unrelated though.

[hughperkins]

Thanks!