On Wed, Nov 10, 2010 at 16:29, Eric Johnson <emjohn...@fusesource.com> wrote: > I want to make sure I understand a few of the issues here: > > We want to make it as easy as possible for people to make changes to > the documentation. > Before a person can edit the wiki they need to sign an icla. > We don't let anyone change the code who hasn't been vetted by the > community and made a committer. > New comers must have their patches vetted by a commiter before they > can be applied. > Any one who signs an icla can change the documentation or Wiki without > being vetted.
That's not entirely true. I mean, I don't think it's an ASF policy. Each PMC decides what to do with permissions afaik. The only mandate is that contributions are done by people with ICLA or express grant (through JIRA patches). A lot of projects don't allow non committers to change docs. Some do. The only difference is that in order to modify svn, you need an apache account, while you don't to modify confluence content. > > If those statements are true I can see two issues: > 1. The barrier for entry on adding content is already relatively high. > 2. If the documentation is as important as the code, then why have the > barrier for entry be different? I say make it the same. Agreed. i don't see why it would be different either. > The tooling question is a different story. Tech writers are a strange > bunch and may be scared by maven, version control, or text editors. It > would be nice to have less "developery" editing tools. > > > On Wed, Nov 10, 2010 at 10:15 AM, James Strachan > <james.strac...@gmail.com> wrote: >> On 10 November 2010 15:00, Hadrian Zbarcea <hzbar...@gmail.com> wrote: >>> That is true, but you can see your changes in the wiki right away. >>> >>> I love the idea of having the docs version controlled, I understand all the >>> benefits. I am also convinced losing the ability to edit in place is a >>> major community issue. >> >> "major community issue" is completely over the top IMHO. >> >> If it really is such an issue, maybe we should switch off subversion >> and put our source code on confluence too? We might get more >> contributions from people who can't use source control.... >> >> >>> Documentation, as shown by the survey, is the #1 issue. >> >> and since we've had it for 3-4 years already, keeping Confluence is >> going to improve the documentation how? >> >> -- >> James >> ------- >> FuseSource >> Email: ja...@fusesource.com >> Web: http://fusesource.com >> Twitter: jstrachan >> Blog: http://macstrac.blogspot.com/ >> >> Open Source Integration >> > > > > -- > Principle Technical Writer > Phone (781) 280-4174 > Skype finnmccumial > E-Mail emjohn...@fusesource.com > Blog http://documentingit.blogspot.com/ > -- Cheers, Guillaume Nodet ------------------------ Blog: http://gnodet.blogspot.com/ ------------------------ Open Source SOA http://fusesource.com
