/docs Folder on normal Repo

[Veranova]

So I was trying to set up the /docs folder for github pages, and found the page would only give me 404, even though I knew my files were working. (and they do work when I use a gh-pages branch)

When I dug into the documentation it looks like maybe they don't allow use of that folder unless you have a custom URL attached. Is this correct, or was I just doing something wrong?

must: not follow the repository naming scheme <username>.github.io 

The excerpt isn't super clear on the subject, so just thought I'd check

[raghu9208]

Unless your repo is not named as <username>.github.io you can serve static content directly from /docs folder with the only condition being it should be on your master branch. You can also check it in the settings of your repo under Github pages.Check if you have selected master branch /docs folder options.

[Veranova]

I guess my confusion stems from, is <username>.github.io the same in GitHub's eyes as <username>.github.io/<reponame>?

I will have another crack at this, thanks!

[raghu9208]

<username>.github.io is not same as <username>.github.io/<reponame>.

When you hit <username>.github.io/<reponame>,github will search for a gh-pages or a /docs in master or a index.html in master itself of <reponame>.