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
