I used the wiki at Github a few times for design proposals and sketches as Ted said and found it quite convenient. So I would be +1 for having a wiki. We can still decide how we want to use it, right?
Fabian 2014-06-11 0:03 GMT+02:00 Robert Metzger <[email protected]>: > Regarding the wiki: In the past, we had access to the GitHub Wiki and it > was not really used (except for GSoC). > > There is only one valid use-case I see for the wiki: We could consider > hosting the documentation in the a and generate the documentation on the > website from the wiki. > This way, we would make it super easy for users to contribute to our > website, and it would also be much easier to maintain the documentation for > developers. > Ideally, the Wiki would also use Markdown to make the import as simple as > possible. > It seems that INFRA is offering Confluence and Moinmoin as Wiki systems. > Both system really don't look (and feel) appealing to me. > There is also a lengthy discussion at Apache CouchDB about exactly the same > issue: > > http://couchdb-development.1959287.n2.nabble.com/CouchDB-Wiki-Documentation-td4682935.html > > Their discussion did not really come to an conclusion, but they are > currently hosting the documentation (outside ASF's infra?) here: > http://docs.couchdb.org/ > The source for the documentation is located in the main source repository > of their project. > So contributors and users have to open pull requests / patches to > contribute to the documentation. > > What do the others think? > > > Regarding Alan's other question: " Also, has someone added permissions for > flink committers to commit to flink’s SVN?" > I think our git repository is properly set up, since I'm able to push into > it. > > > > > On Tue, Jun 10, 2014 at 7:37 PM, Ted Dunning <[email protected]> > wrote: > > > The Apache CMS is pretty easy for posting design proposals as well. > > Supports mark-down. Easy to write. Easy to update. > > > > JIRA attachments work pretty well, also. > > > > But confluence was a complete mess for Mahout. > > > > > > > > On Tue, Jun 10, 2014 at 9:52 AM, Henry Saputra <[email protected]> > > wrote: > > > > > The main use of wiki I could think of that we may miss is to post > > > proposals or design discussions. > > > But we could use dev@ list and JIRA combo to do this. > > > > > > - Henry > > > > > > On Tuesday, June 10, 2014, Sebastian Schelter <[email protected]> wrote: > > > > > > > Hi, > > > > > > > > In Mahout, we made very bad experiences with the wiki. Its superslow, > > > hard > > > > to overlook and people often abuse it to ask questions. I would > suggest > > > to > > > > concentrate on the website and have users contribute content to the > > > website > > > > instead. > > > > > > > > --sebastian > > > > > > > > > > > > On 06/10/2014 05:02 PM, Alan Gates wrote: > > > > > > > >> Sorry for my absence on helping with the infrastructure setup the > last > > > >> couple of weeks. The Hadoop summit and some duties at work took all > > my > > > >> time. Thanks to Robert, Henry, and others for jumping in and > getting > > > stuff > > > >> done. According to my list the only piece of infrastructure not yet > > > setup > > > >> is the wiki. Did you guys want a wiki? Also, has someone added > > > >> permissions for flink committers to commit to flink’s SVN? I don’t > > have > > > >> permission to add the permissions, but I can chase down someone and > > have > > > >> them do it. > > > >> > > > >> Alan. > > > >> > > > >> > > > > > > > > > >
