Place PHP documentation tree on GitHub Pages

[Xymph]

As proposed here, the documentation tree of the PHP code comments could be placed somewhere publicly, like on GitHub Pages. Here we can hash out the details.

Could this be done on https://xymph.github.io/ or is https://hamstar.github.io/ required because of repo ownership?

Which tool to use, which allows automation with GH Pages, which produces the nicest results?

• PHPDoc v2.9.1 or v3.0.0
• PHPDox
• ApiGen (already used by Requests)
• any others?

Plenty to research and experiment...

[waldyrious]

(Copying comment originally added to #104)

If we can use GitHub Actions to automatically generate the HTML documentation and add them to a docs/ folder, then serving them from GitHub Pages should be as simple as this:

We would need access to the repository settings, though. Currently only @hamstar has that level of access. I'll email him to see if he's up for it.

[waldyrious]

Could this be done on xymph.github.io or is hamstar.github.io required because of repo ownership?

We could technically serve the docs from xymph.github.io, but that would be cumbersome because it would require manual syncing of the repositories whenever a change is made to this one, and may be confusing to users due to the latter being marked as a fork of this one. Perhaps we should create an organization for Wikimate? I've emailed @hamstar, let's wait and see what he thinks.