Clarify GitHub stages

Author: coretl

README.rst

@@ -21,7 +21,7 @@ It integrates the following tools:
 - Pre-commit with black, flake8, isort and mypy for static analysis
 - Pytest for code and coverage
 - Sphinx for tutorials, how-to guides, explanations and reference documentation
-- Github Actions for code and docs CI and deployment to PyPI and Github Pages
+- GitHub Actions for code and docs CI and deployment to PyPI and GitHub Pages
 - VSCode settings using black, flake8, isort and mypy on save
 
 The ``skeleton`` branch of this module contains the source code that can be

docs/tutorials/new.rst

@@ -77,17 +77,21 @@ You can then view the docs output with a web browse::
 
     firefox build/html/index.html
 
-Pushing to Github
+Pushing to GitHub
 -----------------
 
-To push the resulting repo to Github, run the following::
+To push the resulting repo to GitHub, first create an empty repo from the GitHub
+website, then run the following::
 
     git remote add $(cat .gitremotes)
     git push -u github master
 
 This will then run the continuous integration (CI) jobs, which run the tests and
 build the docs using the commands above.
 
+Once the docs build has passed, you can use the Settings on the repo page on the
+GitHub website to enable github pages publishing of the ``gh-pages`` branch.
+
 What next?
 ----------
 

src/dls_python3_skeleton/__main__.py

@@ -127,7 +127,7 @@ def main(args=None):
     sub.set_defaults(func=new)
     sub.add_argument("path", type=Path, help="Path to new repo to create")
     sub.add_argument(
-        "--org", default="dls-controls", help="Github org, default dls-controls"
+        "--org", default="dls-controls", help="GitHub org, default dls-controls"
     )
     sub.add_argument(
         "--package", default=None, help="Package name, defaults to directory name"
@@ -143,7 +143,7 @@ def main(args=None):
     sub.set_defaults(func=existing)
     sub.add_argument("path", type=Path, help="Path to new repo to existing repo")
     sub.add_argument(
-        "--org", default="dls-controls", help="Github org, default dls-controls"
+        "--org", default="dls-controls", help="GitHub org, default dls-controls"
     )
     sub.add_argument(
         "--package", default=None, help="Package name, defaults to directory name"