Thanks for coordinating this Josh. Having professional doc writers contributing regularly to the official docs will be an awesome improvement to the project. I am definitely looking forward to working with everyone on this!
On Fri, Apr 24, 2020 at 12:28 PM Joshua McKenzie <[email protected]> wrote: > > > > could be some duplication. > > Absolutely. I was unclear in my original email: this is offered as a > contribution in whatever form best works for the project, and there's > plenty of exceptionally good documentation and work that's already been > done in-tree. The path forward would likely look like taking some pages > wholesale, merging some in with existing content, and ignoring some > entirely which I would leave up to the contributors involved as I haven't > worked on docs in a few years. No plan to steamroll or flatten, all plans > to offer to the community what we want in-tree and in what form and nothing > more. > > Any further questions or comments, don't hesitate. I'm positive there's > other things I inadequately covered in that original email. > > On Fri, Apr 24, 2020 at 12:39 PM Deepak Vohra <[email protected]> > wrote: > > > Joshua, > > That sounds good. But could be some duplication. > > regards,Deepak > > On Friday, April 24, 2020, 04:17:07 p.m. UTC, Joshua McKenzie < > > [email protected]> wrote: > > > > To clarify intent Deepak, we're only talking about donating the Apache > > Cassandra portion of the documentation, nothing else. There is no > > intention whatsoever for anything DataStax branded or related to merge > into > > the in-tree project documentation. > > > > On Fri, Apr 24, 2020 at 11:33 AM Deepak Vohra <[email protected] > > > > wrote: > > > > > > > > While the DataStax documentation could supplement the Apache Cassandra > > > documentation, DataStax is a commercial product based on open source > > Apache > > > Cassandra with enhancements made to the open source Cassandra. > Moreover, > > > DataStax documentation requires to be maintained and updated and as it > is > > > the documentation has not been updated to version 4.0. > > > thanks,Deepak On Friday, April 24, 2020, 03:11:26 p.m. UTC, Joshua > > > McKenzie <[email protected]> wrote: > > > > > > All, > > > > > > A few of us have the opportunity to offer a large portion of > > documentation > > > to the apache foundation and specifically the Apache Cassandra project > as > > > well as dedicate a good portion of time to maintaining this going > > forward. > > > For those of you familiar, this is the DataStax sponsored / authored > > > Cassandra documentation people often refer to in the community. Links > can > > > be found here > > > < > > > https://docs.datastax.com/en/landing_page/doc/landing_page/cassandra.html > > > >. > > > > > > I've spoken with some of the doc writers and there's going to be > > > significant work involved to go from the doc writing system these are > > > authored in to Sphinx, or some other doc authoring system if we as a > > > project decide to switch things. I know Jon Haddad has some opinions > here > > > and I think that'd be a great conversation to have on this thread for > > those > > > interested. A couple of people in the near future are going to have the > > > opportunity to continue working on these docs full-time in the in-tree > > > docs, so maintenance going forward should represent little disruption > to > > > the project's workings day-to-day. > > > > > > Looking for feedback on: > > > > > > 1. > > > > > > Are there any questions or concerns about this donation? > > > 2. > > > > > > Any thoughts on documentation system to use long-term, since a > donation > > > of this size would be a reasonable time to consider switching to > > > something > > > more preferable (not advocating for the system these current docs are > in > > > to > > > be clear - poking Haddad to speak up since he has a strong PoV here > ;) ) > > > 3. > > > > > > What are next steps? > > > > > > > > > I'm genuinely excited about this; here's to hoping everyone else is > too! > > > > > > > > > ~Josh > > > > > >
