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

Subject: Re: [boost] Wiki, website, and stuff..
From: Beman Dawes (bdawes_at_[hidden])
Date: 2015-01-28 07:52:41

On Tue, Jan 27, 2015 at 10:42 PM, Rene Rivera <grafikrobot_at_[hidden]> 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, 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