Re: [PHP-DOC] Getting more people involved.. bye bye Docbook

2013-08-12 Thread Stas Malyshev
Hi! > This means that the users/writers of doc have to learn the syntax > anyway. So in my opinion it would be easier to teach them > rST+Less-Extra-Rules than Mardown+More-Extra-Rules. >From what I see in rST (and please correct me if I am wrong) this is purely presentational markup, as is markd

RE: [PHP-DOC] Getting more people involved.. bye bye Docbook

2013-08-12 Thread Christian Stoller
>> At work we chose reStructuredText[1], because it gives you way more >> elements than markdown and is only slighter harder to write. Plain >> markdown e.g. has no tables, and definition lists, while rST has it out >> of the box. > > > That is pretty much exactly why I didn't want to use it. > It

Re: [PHP-DOC] Re: Getting more people involved.. bye bye Docbook

2013-08-12 Thread Christian Weiske
Hello Hannes, > As an update.. Here is an actually generated page[1] into this new > markdown/rST style format, and its html rendering[2] using the new > tool, wtfm[3]. > > I still haven't received any suggested pure rST versions so will be > continuing using this format for the time being atlea

[PHP-DOC] Re: Getting more people involved.. bye bye Docbook

2013-08-12 Thread Hannes Magnusson
As an update.. Here is an actually generated page[1] into this new markdown/rST style format, and its html rendering[2] using the new tool, wtfm[3]. I still haven't received any suggested pure rST versions so will be continuing using this format for the time being atleast. -Hannes [1] https://ra

Re: [PHP-DOC] Getting more people involved.. bye bye Docbook

2013-08-12 Thread Klaus Silveira
On Mon, Aug 12, 2013 at 10:36 AM, Derick Rethans wrote: > On Sat, 10 Aug 2013, Hannes Magnusson wrote: > > > Keep in mind, no matter what format we choose we do need to roll our > > own engine. > > > > > It would also be a big transition from docbook to another format. > > > We'd definitely need

[PHP-DOC] Contributions are ready for review

2013-08-12 Thread phpdoc
Hello PHP EN Documentation team, There are contributions within the online editor queue for this language. Please review, then commit or delete these patches. Patches for review : --- New file: en/reference/sqlite3/sqlite3/createcollation.xml By: b dewar on 2013-04-1

Re: [PHP-DOC] Getting more people involved.. bye bye Docbook

2013-08-12 Thread Derick Rethans
On Sat, 10 Aug 2013, Hannes Magnusson wrote: > Keep in mind, no matter what format we choose we do need to roll our > own engine. > > > It would also be a big transition from docbook to another format. > > We'd definitely need a translation tool to help us. I'm not sure > > what is out there,