Create docs and configure settings

[PhilipDeegan]

Pretty sure we can use a docs folder in the master branch, should
https://help.github.com/articles/user-organization-and-project-pages/

https://github.com/sparsehash/sparsehash-c11/tree/master/docs/index.html
could be accessible from
https://sparsehash.github.io/sparsehash-c11

See: https://help.github.com/articles/configuring-a-publishing-source-for-github-pages/

[donovanhide]

Want to move the docs across and see if the urls work? Didn't know about the docs folder feature, very useful!

Additionally we could consider porting the docs to markdown from HTML and see if that works with this scheme?

I guess the real question that comes up from this is that Google searches for sparsehash will probably end up coming to the C++11 repo, which means we need to have a long think about how to explain the fork from the old repo. Are we planning to merge this repo back into the old repo at any point? Or is this a fork, for which we support in terms of packages for brew/apt/etc.? In which case we need to choose a non-clashing name for the include path.

[PhilipDeegan]

Will do, I don't have the permissions (I believe) to configure the settings for gh-pages as noted in the links though.

I'm in favor of promoting this to the official version, and letting https://github.com/sparsehash/sparsehash become legacy.

The question arises, should the changes made by @greg7mdp be merged in, does it make sense to?

[donovanhide]

You have write permissions, don't you? Only one above is that is admin, for adding more people.

I think the gh-pages branch is not needed if we just create the docs folder?

Yep, we should apply all the patches from the main repo to this one. Are you volunteering? :-)

[donovanhide]

Ahh, do you mean the /docs option in the settings is greyed out? I think that is just because the docs folder does not yet exist?

[PhilipDeegan]

this

I can't do 3/4/5

[donovanhide]

Tip: The master branch /docs folder source setting will not appear as an option if the /docs folder doesn't exist on the master branch.

[PhilipDeegan]

I've added a temporary index.html under /docs

I don't have access to change the settings, if you would please.

I'll merge in the changes too

[donovanhide]

Admin rights assigned :-) Github has a very confusing ACL system...

[PhilipDeegan]

Ahah, thanks.

Success

[PhilipDeegan]

#9

[PhilipDeegan]

To update docs with link to gh-pages and with modified include path mentioned in #8