Serving of new files as HTML pages confusingly delayed

[pbodnar]

It looks like one sometimes needs to make another commit to the repository in order to get previously added files as HTML pages, when using the "GitHub Pages" functionality. Otherwise one gets only "404 Not Found" when trying to access those new files even after several minutes.

The behavior seems to be a bit random, or dependent on the exact changes flow - sometimes, the new page is served right away without user intervention, sometimes not.

Reproduction

Here is one of the possible reproduction steps:

1. Create a new user repository.
2. Add README.md to it.
3. Add another.md to it.
4. Go to project Settings and activate the "GitHub Pages" from there (select master branch as the source).
5. Try to go to https://<user>.github.io/<repository>/ (index page - it should be created from the README.md) or to https://<user>.github.io/<repository>/another (this should render the HTML from another.md).

Error: You'll get "404 Not Found" error when trying to access those pages. And pressing Ctrl+F5 for forced page reload doesn't help.

Workaround: For example, add another ".md" file to the repository. Again, it won't get visible as an HTML page, but the previously added files get visible now.

Expected behavior

Every change made should be visible as a corresponding HTML page right away. Or at least there should be some information that the changes are yet to become effective - there is no such thing on the /deployments page - it just says <commitId> was deployed by @github-pages GitHub Pages 3 minutes ago (Active) even when the pages added in the linked commit are not visible even after 5 minutes.

[pbodnar]

Maybe I should have reported this on https://github.com/github/pages-gem/ instead?

[github-actions[bot]]

Stale issue message

[github-actions[bot]]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.