Instructions for how to turn on GitHub actions could be in createGithubPagesAction

[kellijohnson-NOAA]

Proposal

It would be so great if you could add the instructions for how to turn on GitHub pages to the GitHub action file created by createGithubPagesAction(). For example, I recently used a GitHub template to create a repository and immediately got an email notification saying a GitHub action had failed. If the instructions on how to turn on GitHub pages had been in the workflow I personally would have been able to fix the broken action sooner. I eventually was able to find the instructions both on your site and the template site but I still would appreciate them being written as comments in the action file itself.

Additional notes

I am happy to submit a pull request for this feature if it is wanted.

[choldgraf]

Pull request welcome! I think this would probably best be in the jupyter book repo if you're using JB for your workflow. We are using JB for tutorials and more end user facing docs, and mystmd for more reference and developer docs. Would you like to open a PR against the "next" branch in jupyter book?

[rowanc1]

Thanks @kellijohnson-NOAA -- put the comment in #1778. Hopefully that helps others in the future.

If there are other places that this needs to be (e.g. in a template repo?) please do help the ecosystem out by getting a pull request in those places!

@choldgraf I think the docs are pretty complete here, but they don't help out users who have cloned downstream templates like pythia.