Hi all, Pivotal currently is working through the process of converting the existing Geode manual from DITA to the more open-source-friendly markdown. The value in this is that anyone will be able to contribute, rather than just folks who have access to DITA editors.
Our automated conversion introduced some bugs that we're manually cleaning up now. Once that's done, we'll be ready to move the manual into an Apache repo and host it on the website. Regarding the repo: Do Apache projects usually use the same repo for code and for documentation, or do they separate them so that adding to or editing the docs doesn't necessitate kicking off an application build? Best, Joey On Thu, Jun 23, 2016 at 9:20 AM Nitin Lamba <nla...@apache.org> wrote: > From a technology readiness perspective, hosting the docs on a different > (Apache) site should not be too hard; I've built the docs locally and on > AWS without any major issues. > > Irrespective of the hosting location, the content license needs to be fixed > - as per the current github repo [1], it still has Pivotal copyright though > the generated pages (ruby/ markdown to HTML) has ASF copyright in the > footer. > > Nitin > [1] https://github.com/project-geode/docs > > > On Wed, Jun 22, 2016 at 6:10 PM, Gregory Chase <gch...@pivotal.io> wrote: > > > This is an interesting topic. > > > > I've noted Planet Cassandra has free high quality vendor support on > behalf > > of the Apache Cassandra project. > > > > What is appropriate in terms of core content in the community versus > > adjunct members of the community such as companies to create derivative > > works? > > > > I could imagine the collaborative authoring of documentation might take > > place on the wiki, for example. However companies interested in creating > > commercial derivatives might choose to take this content, do additional > > editing, add proprietary value-added information, and lay it out in a > more > > visually pleasing manner. > > > > -Greg > > > > On Wed, Jun 22, 2016 at 5:54 PM, Niall Pemberton < > > niall.pember...@gmail.com> > > wrote: > > > > > On Fri, Apr 29, 2016 at 10:28 PM, Dave Barnes <dbar...@pivotal.io> > > wrote: > > > > > > > We plan at some point to donate the docs so they'll be incorporated > > into > > > > the repo. Is this a prerequisite to graduating from incubation? > > > > > > > > > > What is the status of the docs being donated? I raise this because the > > > Cassandra project was recently given a hard time by a board member > about > > > docs hosted on a vendor site[1]. > > > > > > [1] http://markmail.org/message/uqsizgjxi7lwjcv7 > > > > > > Niall > > > > > > > > > > > -- > > Greg Chase > > > > Global Head, Big Data Communities > > http://www.pivotal.io/big-data > > > > Pivotal Software > > http://www.pivotal.io/ > > > > 650-215-0477 > > @GregChase > > Blog: http://geekmarketing.biz/ > > >
