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

On 10 August 2013 06:34, Hannes Magnusson wrote: > Hello > > I've been thinking lately about how we can make it easier for people > to contribute to the project.. > > The OE was a great improvement and made it whole lot simpler to get > going for users and did its job pretty well. > > Editing xml

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

On Fri, Aug 16, 2013 at 2:59 AM, Derick Rethans wrote: > On Tue, 13 Aug 2013, Hannes Magnusson wrote: > > > On Mon, Aug 12, 2013 at 11:48 PM, Stas Malyshev > wrote: > > > > > >> This means that the users/writers of doc have to learn the syntax > > >> anyway. So in my opinion it would be easier t

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

On Tue, 13 Aug 2013, Hannes Magnusson wrote: > On Mon, Aug 12, 2013 at 11:48 PM, Stas Malyshev > wrote: > > > >> 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-Ru

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

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

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

> 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

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

Just my 0.02 I like MD and rST, but I think Markdown, in particular with the extensions in: http://michelf.ca/projects/php-markdown/extra/, shoould suffice for just documentation. Semantic content, which is something people were refering to, might be given by the file/directory structure, rather

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

For me same as: ```php https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet#code-and-syntax-highlighting this is totally readable to me, and in `github days`, people are more comfortable with some markdown (they love README.md) IMHO, this change will let more people contribute wit

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

On 14/08/13 06:04, Christian Weiske wrote: Have you people considered simply moving the documentation to a wiki? For example, MediaWiki? * Build time in seconds. * Wikitext syntax is as simple as any other presented so far. No. Mediawiki's syntax is a pile of stinking something. There is not e

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

On 13/08/13 19:28, Rafael Jaques wrote: Bjori example's seems easier to figure out what's going to happen. I vote Markdown ratter than Wiki, because you can learn just reading another person's work. I wouldn't know, I don't see how is # DESCRIPTION or DESCRIPTION === any easier to

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

Hello Nikola, > Have you people considered simply moving the documentation to a wiki? > For example, MediaWiki? > > * Build time in seconds. > * Wikitext syntax is as simple as any other presented so far. No. Mediawiki's syntax is a pile of stinking something. There is not even a formal syntax

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

Bjori example's seems easier to figure out what's going to happen. I vote Markdown ratter than Wiki, because you can learn just reading another person's work. Um abraço, :: Rafael Jaques (phpit.com.br ) :: Cristão - Professor - Evangelista PHP :: "Se confessarmos os nosso

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

On 10/08/13 07:34, Hannes Magnusson wrote: I've been thinking lately about how we can make it easier for people to contribute to the project.. The OE was a great improvement and made it whole lot simpler to get going for users and did its job pretty well. Editing xml however isn't something the

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

On Mon, Aug 12, 2013 at 11:42 PM, Christian Stoller wrote: >>> 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. >> >

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

On Mon, Aug 12, 2013 at 11:48 PM, Stas Malyshev wrote: > 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

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

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

>> 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] Getting more people involved.. bye bye Docbook

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

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

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,

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

Related to rST, does anyone around here have much experience with readthedocs.org? http://readthedocs.org/ Maybe we could host it there as well :) It appears they use transifex.com for translations. Just thinking out loud... Regards, Philip

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

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

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

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

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

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

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

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

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

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

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

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

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

Hello I've been thinking lately about how we can make it easier for people to contribute to the project.. The OE was a great improvement and made it whole lot simpler to get going for users and did its job pretty well. Editing xml however isn't something the general public seems to be willing to