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

2013-08-10 Thread Hannes Magnusson
On Sat, Aug 10, 2013 at 1:15 PM, Levi Morrison wrote: > After looking at what Hannes proposed, I think it is simple and fairly > usable. I see potential parsing issues in the synopsis section, though. The > code portion of that section should be marked somehow, perhaps with: > > ``php-synopsis > >

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

2013-08-10 Thread Jefersson Nathan
And the comments? Em 10/08/2013 17:15, "Levi Morrison" escreveu: > After looking at what Hannes proposed, I think it is simple and fairly > usable. I see potential parsing issues in the synopsis section, though. The > code portion of that section should be marked somehow, perhaps with: > > ``php-

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

2013-08-10 Thread Levi Morrison
After looking at what Hannes proposed, I think it is simple and fairly usable. I see potential parsing issues in the synopsis section, though. The code portion of that section should be marked somehow, perhaps with: ``php-synopsis int function strpos( string $haystack, mixed $needle,

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

2013-08-10 Thread Hannes Magnusson
On Sat, Aug 10, 2013 at 12:12 PM, Nikita Popov wrote: > On Sat, Aug 10, 2013 at 9:01 PM, Hannes Magnusson > wrote: >> >> That is pretty much exactly why I didn't want to use it. >> It was just to much. I actually need to learn the syntax before I can >> write it. >> >> I don't want the the strong

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

2013-08-10 Thread Nikita Popov
On Sat, Aug 10, 2013 at 9:01 PM, Hannes Magnusson < hannes.magnus...@gmail.com> wrote: > That is pretty much exactly why I didn't want to use it. > It was just to much. I actually need to learn the syntax before I can > write it. > > I don't want the the strong semantics relations anymore. Dirt si

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

2013-08-10 Thread Hannes Magnusson
On Sat, Aug 10, 2013 at 4:24 AM, Davide Pastore wrote: > > Il 10/08/2013 7.34, Hannes Magnusson ha scritto: > > What do you guys think? :) > > It's a great idea! If it can help you, you should also take a look at this > page. > Do you think that a validator for the markdown text is as efficient a

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

2013-08-10 Thread Hannes Magnusson
On Sat, Aug 10, 2013 at 2:45 AM, Christian Weiske wrote: > Hello Hannes, > > >> 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. >> >> Looking around the web.. People seem pretty happy with Markdown... >> Now

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

2013-08-10 Thread Rasmus Lerdorf
On 08/10/2013 01:34 AM, Hannes Magnusson wrote: > I've already started working on a PhD output format to help with the > transition. > The current format I am targetting looks something like the document attached. I really like that format. I might even write more with this since I am unlikely t

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

2013-08-10 Thread Davide Pastore
Il 10/08/2013 7.34, Hannes Magnusson ha scritto: What do you guys think? :) It's a great idea! If it can help you, you should also take a look at this page . Do you think that a validator for the markdown text is as efficient as that for xml? Have a nice day Davide

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

2013-08-10 Thread Christian Weiske
Hello Hannes, > 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. > > Looking around the web.. People seem pretty happy with Markdown... > Now, markdown has its obvious crazy huge drawbacks when it comes to >

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

2013-08-10 Thread Yasuo Ohgaki
On Sat, Aug 10, 2013 at 2:34 PM, Hannes Magnusson < hannes.magnus...@gmail.com> wrote: > What do you guys think? :) Great idea! +1 -- Yasuo Ohgaki yohg...@ohgaki.net