Help
cancel
Showing results for 
Search instead for 
Did you mean: 
Highlighted
Ground Controller Lvl 1
Message 1 of 4

Source set to master/docs but still loading from gh-pages?

I have trawled through the very similar issues on here but just cannot for the life of me work out what I'm doing wrong.  Trying GH Pages with Sandcastle building my Help pages.

Repo - https://github.com/TeamControlium/Utilities.net

 

I created a folder /docs in the master branch and in Setting set Source to master branch /docs folder:-

Capture.JPG

 

 

 

 

 

 

 

 

 

 

However, I got a 404 error browsing to the URL.  So I tried the gh-pages route and created a gh-pages branch with the help pages and set the Source to gh-pages.  Hey presto, it worked!

 

But I dont want to use a gh-pages branch, I want to use a /docs Source as the documentation is autogenerated on a build.  So I set the Source back to master branch /docs folder. But it still gets the Source from gh-pages branch.

 

What am I getting wrong here (I have looked through Help stuff and guess I'm missing something - but not sure what...)?  Why is it allowing me to select /docs as the Source but ignoring it?

 

3 Replies
Highlighted
Commander Lvl 1
Message 2 of 4

Re: Source set to master/docs but still loading from gh-pages?

Hey @v-mwalk, can you try deleting the gh-pages branch?

Highlighted
Ground Controller Lvl 1
Message 3 of 4

Re: Source set to master/docs but still loading from gh-pages?

Wow - quick reply Logan.  Thanks...

Well this is just weird. :-)

After I put this post up, tried again - put the Source back to /docs.  It worked!!!???

 

So I then copied the Pages assets over to master/docs and deleted the gh-pages branch.  Indeed it worked!!  So, fixed.

 

However (The Tester in me coming out now lol), there is a possible defect here.  When I first tried it with no gh-pages branch, a 'test Hello World' index.html file in master/docs and Source set to master/docs I did get a 404.  To confirm is was not a timing thing I verified it the next morning to be sure - indeed still getting a 404.  That is the 'possible' defect - can it be repro'ed or was/is there some other funny setting in my repo that is the cause?

 

The fix (which was kinda me just messing around trying stuff) was to;

 

- create a gh-pages branch with the index.html & pages in and set Source to gh-pages (then try it to verify it works).

 

- then change the Pages source to /docs (with an index.html file to prove /docs is being used now).  Try it to prove it has indeed changed Source.

 

- move actual pages content from gh-pages branch to /Docs and check it in.  Voila! It works....

Highlighted
Commander Lvl 1
Message 4 of 4

Re: Source set to master/docs but still loading from gh-pages?

Thanks for testing things out. I don't have any special ability to report these sort of things so paging @AndreaGriffiths11