Re: [boost] Wiki, website, and stuff..

On Wed, Jan 28, 2015 at 1:52 PM, Beman Dawes wrote:

On Tue, Jan 27, 2015 at 10:42 PM, Rene Rivera wrote:

...

I was contemplating editing the release schedule documentation < https://svn.boost.org/trac/boost/wiki/ReleaseSchedule> and thinking if it would be better to start moving such documentation away from the Trac wiki. And I think it is a good idea to move that documentation elsewhere. Especially if it's some place where it's easier to manager the editing permissions and contributions. So I was thinking about what options we had. What I'm aware of as choices are:

* Another project in Github just for wiki like documentation.

* Using the website project wiki for it.

* Adding it directly to the website given how easy it is to edit online now. Although not so easy to preview because of the way the web site works.

* A github pages site of some sort.

Are there other options? Any opinions on the above options?

There are really two issues IMO:

* Docs primarily for release managers. We already have the boostorg/release repo, so we can either add release manager docs to its directory tree or use its wiki. The wiki approach encourages all release managers to help keep the docs up-to-date. Docs in the directory tree brings all the advantages of git distributed version control,

One quick comment I would like to throw in here: Wikis on GitHub are stored in Git repositories and come with all advantages of git distributed version control.

and we can also use gh-pages mechanism. The wiki approach is somewhat lighter weight and so may be better for casual documentation.

* Other trac wiki pages: I don't think there is a single answer. Each subset of pages needs to be looked at since some should be abandoned, some moved to a boostorg or boostorg/project wiki, and some (like developer related docs) should probably go in either the super-project repo or a new developer repo.

--Beman

_______________________________________________ Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost