Documentation

2016-06-07 Thread Jonathan Ellis
Hi all,

In light of the confusion around documentation (people asking on dev list
about driver docs or DataStax docs), I think we should accelerate the plans
to finish migrating our official documentation from the MoinMoin wiki to
our source tree.

Briefly, the technical problems with Moin aren't going away and having the
docs in tree means we can version them by release for free.

(We still want to use a wiki for contributor-oriented pages like
HowToContribute, but user-level docs like GettingStarted and Operations
will be moved into tree.  And even the contributor wiki needs to move to
Confluence  because
MoinMoin sucks.)

I've attached an outline of what I think we need to migrate to the ticket
.


Re: Documentation

2016-06-07 Thread Mattmann, Chris A (3980)
Thanks for pushing this forward, Jonathan.

I appreciate your help and for taking my comments and 
moving forward as a community.

Cheers,
Chris

++
Chris Mattmann, Ph.D.
Chief Architect
Instrument Software and Science Data Systems Section (398)
NASA Jet Propulsion Laboratory Pasadena, CA 91109 USA
Office: 168-519, Mailstop: 168-527
Email: chris.a.mattm...@nasa.gov
WWW:  http://sunset.usc.edu/~mattmann/
++
Director, Information Retrieval and Data Science Group (IRDS)
Adjunct Associate Professor, Computer Science Department
University of Southern California, Los Angeles, CA 90089 USA
WWW: http://irds.usc.edu/
++









On 6/7/16, 1:34 PM, "jbel...@gmail.com on behalf of Jonathan Ellis" 
 wrote:

>Hi all,
>
>In light of the confusion around documentation (people asking on dev list
>about driver docs or DataStax docs), I think we should accelerate the plans
>to finish migrating our official documentation from the MoinMoin wiki to
>our source tree.
>
>Briefly, the technical problems with Moin aren't going away and having the
>docs in tree means we can version them by release for free.
>
>(We still want to use a wiki for contributor-oriented pages like
>HowToContribute, but user-level docs like GettingStarted and Operations
>will be moved into tree.  And even the contributor wiki needs to move to
>Confluence  because
>MoinMoin sucks.)
>
>I've attached an outline of what I think we need to migrate to the ticket
>.