And if you’d like to preserve the documents’s names in the repository (for end users’ sake) you could then create a copy renamed to
index.html of these HTML documents in the
docs/ subfolder (also copying the CSS and JS assets into it) and change the repository settings for GH Pages to serve website contents from the
docs/ subfolder instead of the root folder — this way you’ll be able to keep the custom filenames and also show them as the GH Pages home page.
You could add a shell script to carry out the copy and rename operations to automate the process, making it easier to keep the copies in synch with the original files, whenever you update the sources.
Furthermore, if you wish that end users downloading the project via the download button shouldn’t receive the redundant
docs/ folder, but only the main files in the project root, you could exclude the folder and its contents from the generated Zip archive by adding an export-ignore rule in the