How about we scope that to everything that needs revisions/comments?
On Wed, Jul 20, 2016 at 3:23 PM, Henry Robinson <[email protected]> wrote: > Seems reasonable, but I propose we scope that only to design documents > (which require revisions and comments). > > FWIW, Kudu includes building-from-source instructions on their website > (which I think is nicely done): > http://kudu.apache.org/docs/installation.html#_build_from_source > > I'm happy with most content going on the wiki. > > On 20 July 2016 at 09:44, Marcel Kornacker <[email protected]> wrote: > >> A lot of our developer docs are Google docs, which facilitate >> commenting, and it would be good to keep it that way. >> >> Should we link to those docs from the Apache Impala wiki? >> >> On Wed, Jul 20, 2016 at 9:06 AM, Tim Armstrong <[email protected]> >> wrote: >> > I also think the wiki is the best approach. >> > >> > On Wed, Jul 20, 2016 at 8:55 AM, Jim Apple <[email protected]> wrote: >> > >> >> I think Tom's points are correct. >> >> >> >> Another option would be plain text or markdown files inside the git >> >> repo. Those would be harder to update, but then would have review for >> >> developer docs changes, which might be nice. >> >> >> >> FWIW, right now getting a wiki login requires asking for one on this >> >> mailing list because of spambots. >> >> >> >> On Wed, Jul 20, 2016 at 1:37 AM, Tom White <[email protected]> wrote: >> >> > On Wed, Jul 20, 2016 at 4:56 AM, Dimitris Tsirogiannis >> >> > <[email protected]> wrote: >> >> >> Hi community, >> >> >> >> >> >> We need to move our developer documentation to a proper location. >> >> >> Currently, it's in Cloudera's internal wiki and in the wiki pages of >> the >> >> >> Cloudera Impala git repo ( >> >> >> https://github.com/cloudera/Impala/wiki/Contributing-to-Impala). >> >> >> >> >> >> The options are: >> >> >> * Impala's webpage (http://impala.io/) >> >> > >> >> > This is moving to http://impala.incubator.apache.org/, so it's the >> >> > equivalent of the third option (below), isn't it? >> >> > >> >> >> * Apache hosted Impala wiki ( >> >> >> https://cwiki.apache.org/confluence/display/IMPALA/Impala+Home) >> >> > >> >> > This is probably the best since a wiki is the most frictionless way of >> >> > updating dev docs. >> >> > >> >> >> * Apache hosted Impala webpage (http://impala.incubator.apache.org/) >> >> >> * The wiki pages of the Apache Impala git repo ( >> >> >> https://github.com/apache/incubator-impala) >> >> > >> >> > This isn't hosted on ASF infrastructure (unlike source code which is >> >> > mirrored), so I think we can rule this one out. >> >> > >> >> > Thanks, >> >> > Tom >> >> > >> >> >> >> >> >> Please state your preference. >> >> >> >> >> >> Dimitris >> >> >> > > > > -- > Henry Robinson > Software Engineer > Cloudera > 415-994-6679
