https://quarto.org/docs/publishing/github-pages.html

There are three methods of publishing mentioned in Overview, but the page hierarchy makes it look like there are two, and the GitHub Action method in buried inside the Publish command.

<img width="161" alt="Screen Shot 2023-02-23 at 3 36 03 PM" src="https://user-images.githubusercontent.com/25964/221055604-c82bbd59-7af6-4195-915a-347c2b82207d.png">

Current sections in "Publish Command":
* [Publish Command](https://quarto.org/docs/publishing/github-pages.html#publish-command)
  * [Source Branch](https://quarto.org/docs/publishing/github-pages.html#source-branch)
  * [Ignoring Output](https://quarto.org/docs/publishing/github-pages.html#ignoring-output)
  * [Publishing](https://quarto.org/docs/publishing/github-pages.html#publishing)
  * [GitHub Action](https://quarto.org/docs/publishing/github-pages.html#github-action)
  * [Executing Code](https://quarto.org/docs/publishing/github-pages.html#executing-code)

We need to clarify that "Source Branch" and "Ignoring Output" are both required prerequisites for `quarto publish gh-pages`.  Then "Publishing" (perhaps better named Local Publish, or Local Render) and "GitHub Action" (e.g. GitHub renders and publishes) are two different ways to use `quarto publish gh-pages`. "Executing Code" is only relevant to "GitHub Action".

Proposed changes:
*  Rework overview to be clearer that although there are three options, the second two both involve the publish command (`quarto publish`): rendering and publishing locally, or using GitHub to render and publish.
* Rename and reindent sections in Publish Command:
  * Create new section Prerequisites under "Publish Command" (move existing top-level content from Publish Command into this) 
   * Make Source Branch a level 4 heading
   * Make Ignoring Output a level 4 heading 
   * Rename "Publishing" -> "Local Render"
   * Executing Code a level 4 heading

After these changes the hierarchy should look like:
* Publish Command
  * Prerequisites
    * Source Branch
    * Ignoring Output
  * Local Render
  * GitHub Action
    * Executing Code


cwickham
2023-02-23T23:37:40Z
cwickham
documentation good-first-issue
v1.4
open
Fix section headings in GitHub Pages Publish Docs
https://github.com/quarto-dev/quarto-cli/issues/4519