> > 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 <dvohr...@yahoo.com.invalid> 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 < > jmcken...@apache.org> 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 <dvohr...@yahoo.com.invalid> > 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 <jmcken...@apache.org> 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 > > >
