Github Pages tutorial creates some confusions for beginners
dkrasne opened this issue · 3 comments
dkrasne commented
Discussed in https://github.com/orgs/skills/discussions/105
See below for some things that need to be fixed in the tutorial instructions for GitHub Pages.
Originally posted by dkrasne October 30, 2022
Here are a few hitches I ran into while setting up GitHub Pages from the tutorial:
- Under 'how to start this course,' the screenshot is from introduction-to-github, not github-pages. It's not clear whether one should choose the name of one's future blog address, or if it makes sense to leave the default name of github-pages. This should be clarified.
- Step 1, instruction 3 ("Click Pages, in the "GitHub Pages" section, use the Source drop-down, then select main branch.") did not match exactly what I saw. 'Main branch' was not an option under the Source drop-down; the only option other than GitHub Actions was "Deploy from a Branch". The SECOND drop-down menu (under Branch, not Source) gave "main" as an option.
- I'm concerned that because of one or both of these unclear instructions, I did something wrong at some point, because when I go to my new page (currently at https://dkrasne.github.io/github-pages/ although I plan to rename it if I can't figure this out), the bottom of the page reads: "github-pages" and "Lesson on building a blog with Jekyll". So I think I must have done something wrong (especially since I had to search for the button to merge the pull request, it didn't show up automatically), but I can't figure out where, since I followed all of the subsequent instructions precisely.
- Even if I actually did everything correctly, those two unclear instructions should be changed, for the sake of beginners.
Help would be appreciated, thanks!
markdav-is commented
I had a similar experience #154
sinsukehlab commented
Hitch 2 (about GitHub Pages drop-down menu) is resolved in #18.