New Website Documentation Improvement

[Paul-TT]

The current documentation for creating a new ASF website doesn't have great information for using the new ASF Infrastructure Pelican Action. I am finding that the documentation on how to get started is cyclical and i'm not finding the information on how to actually get started with the new infrastructure.

If I start here, https://infra.apache.org/asf-pelican.html, the notes indicate that one should use the 2024 Github action oriented version over the old 2019 ASF-Pelican version. When I click on the link for the ASF Infrastructure Pelican Action repo, there aren't any instructions on how to use this new version with the ASF Pelican website theme. The first lin in the read me for more information takes you right back to first page https://infra.apache.org/asf-pelican.html.

From https://infra.apache.org/asf-pelican.html, if I click on the get started link, https://infra.apache.org/asf-pelican-gettingstarted.html, the third paragraph specifies that the information below on how to get started only pertains to using the old 2019 version.

It would be really helpful if there was a step by step guide how to get up an running locally using the ASF Pelican website theme and the ASF Insfrastructre Pelican Action.

Apologies if I'm just missing something but I have gone through the docs several times and felt like I kept going in circles.