I just make the effort to review a lot of english files in the online editor (work in progress section) ; some of its are in the online editor since 1 year !
As english is not my native langage, it's hard for me to validate or not a change. So, I validate some, and all others were just trashed. I see that this discussion is again arround to put the documentation into Github, and really, if there is no contributor to review some old files into the editor, I just don't see why there would be some to review some pull requests. The editor send an email per week into this list to warn about pending patchs into the editor ; there is 2 links above each patch : one to validate, one to delete. The decision take about 1 minuts and yet, there is always a pending patch from April/2013... I think we can change the format of the documentation, and read with attention all discussion about that ; I will be able to help with this change to reflect all of it into the online editor. But before continuing to discuss around Github vs SVN, It will be more constructive to found somes reviewers to commit all change proposed by anonymous lector of our documentation in a reasonable time. As usual, if somethings must be change into the online editor to work better with all this contribution, I will be pleased to develop it. Please, keep in mind that the online editor is used by a lot of translators ; you shouldn't consider the documentation as exclusively english documentation. Best, Yannick (online editor developper & french translator) 2013/8/16 Niel Archer <niel.arc...@blueyonder.co.uk> > > Hello > > > > I've been thinking lately about how we can make it easier for people > > to contribute to the project.. > > The bigest block to me getting more involved is SVN and the lack of > offline tools that will work with how Docbook is implemented by the > project (piecemeal files that a DocBook editor cannot include > automatically for validation). > > > The OE was a great improvement and made it whole lot simpler to get > > going for users and did its job pretty well. > > It is, but it's still a lot of work to do anything more than simple > edits. It also blocks further edits once one is saved, even if it isn't > made into a patch. > > Also, the number of contributions that have been awaiting review for > weeks, does nothing to encourage potential contributors. Even if a > contribution is rejected, provided it is done with constructive comments, > is better than stagnating in the OE, potentially holding up further > commits to the same document. > > > Editing xml however isn't something the general public seems to be > > willing to do, not to mention they have no idea what docbook is at > > all. > > True, but PHP users aren't the general public, most are at least familar, > if > not experienced, with it > > > Other pain points are how long it takes to validate and build the > > documentation - and the cheesy tricks we've had to deploy to squeeze > > every performance drop out of both PHP and XML. > > Much of this pain seems to be because of implementation details, see > above comment concerning offline tools > > > If you guys remember our story.. > > DSSSL rendering took _days_ to build. > > XSLT took _hours_. > > PhD takes _minutes_. > > I think we can do better. > > I want it down to _seconds_. > > > I've been toying with the idea of retiring my baby on its 6year old > > birthday early October.. And replace it with something new. Faster. > > Easier. Better. > > > I however don't think we can do that with XML. > > And I want to make it even easier to contribute - with essentially no > > learning curve. > > > > > What do you guys think? :) > > I suggest fixing the above problems first. Changing the format without > getting rid of these bottle-necks will be a superficial change. One that > will cause many current contributors to have to learn a new format, > regardless of which is chosen > > The biggest help to me, and to many others I believe, would be moving > the documentation project to Github. Easy forking, commiting, followed > by pull requests that don't block other peoples work would speed the > process. Provided of course that the PRs get reviewed. > > > > > -Hannes > >
