First: I am positively surprised how many guys would like to contribute to docs.
Some days ago I posted to the dev-list about doc-contribution. I think this applies here again. From my point of view "in-tree docs" are a good choice for technical references that go closely with the code versioning. But for content-oriented docs like tutorials, FAQs, Knowledge base I think this is not a good place especially if the doc-contributors are not that deeply involved into dev/code. For that purpose, Stefan Podkowinsky created a repo for collaboration that "Proxies" access to the CS repo. Thats a nice gesture but IMHO that can only work as an intermediate solution. "User-Docs" do not require a CI or complex build + publishing process. They require a simple and "beautiful" way to contribute. Especially if you wish to encourage more "outside" users to contribute. Isn't there a way to split tech docs (aka reference) and more user-generated and use-case related/content oriented docs? And maybe to use a more modern WIKI software or scheme. The CS wiki looks like 1998. 2017-03-12 23:26 GMT+01:00 Jeff Jirsa <jji...@gmail.com>: > We're trying to use the in-tree docs. Those are preferred, updating the > wiki is OK, but the wiki is VERY out of date. > > -- > Jeff Jirsa > > > > On Mar 12, 2017, at 3:21 PM, Long Quanzheng <prc...@gmail.com> wrote: > > > > Is the wiki still being used? > > https://wiki.apache.org/cassandra > > says: > > Cassandra is moving away from this wiki for user-facing documentation in > > favor of in-tree docs, linked below. (Pull requests welcome > > <https://github.com/apache/cassandra/tree/trunk/doc>!) > > > > > > 2017-03-12 14:21 GMT-07:00 Brandon Williams <dri...@gmail.com>: > > > >> I've added you. > >> > >> On Sun, Mar 12, 2017 at 1:43 PM, ThisHosting.Rocks! < > >> contact@thishosting.rocks> wrote: > >> > >>> Hi, > >>> > >>> > >>> My username is NickReiner and I'd like to contribute to the Cassandra > >> wiki. > >>> > >>> Please. :) > >>> > >>> Nick Reiner > >>> THR Support. > >>> > >> >
