The README.md file must be removed from the branch because, apparently, it takes precedence over the index.html that is published to the gh-pages branch.
The GitHub username in the github.io URL must be lowercase, otherwise a confusing "Cannot resolve DNS entry" error (or something like that) is issued by Maven.
After this term is over (and people aren't merging from upstream anymore), I'll change the README.md and the pom.xml. It'll probably make sense to create a gh-pages branch in this repository so that it's easier for the students to work with.
When I demonstrating creating a Maven Site for the project, I realized that there were a couple of things that were missing in the instructions.
gh-pages
branch should really be created from the initial revision of the repositorygit checkout 62fc42c5b0cf4ddddf78e7568b008bedc9037b38
README.md
file must be removed from the branch because, apparently, it takes precedence over theindex.html
that is published to thegh-pages
branch.github.io
URL must be lowercase, otherwise a confusing "Cannot resolve DNS entry" error (or something like that) is issued by Maven.After this term is over (and people aren't merging from
upstream
anymore), I'll change theREADME.md
and thepom.xml
. It'll probably make sense to create agh-pages
branch in this repository so that it's easier for the students to work with.