On 30 Oct 2013, at 21:51, Stéphane Ducasse <stephane.ducasse@inria.fr> wrote:
Well were are the books you wrote with this wonderful format? The only guy I can consider is sven. Why because he is writing real documentation. Now I'm confident that sevn could write in pier syntax because this is really close to markdown. What is missing is the immediate rendering of pier syntax as in the collabactive book.
I havenât written any books. But I donât feel bad for asking the things that I what to hear other peoples opinion about.
Stef
On Oct 30, 2013, at 8:09 PM, Camillo Bruni <camillobruni@gmail.com> wrote:
Iâm not looking for simplicity, Iâm looking for a good final product. ePub shouldnât be simpler, itâs just made for eBooks. On the other hand there are editors with WYSIWYG support like:http://1.bp.blogspot.com/-K2Q-tdVbPRI/UI08v7LhzHI/AAAAAAAAABY/vZ5LHjM6nb4/s1... And of course there is iBooks Author that I mentioned.
Iâm not trying to convince, Iâm just trying to understand why development of a new syntax is better the reusing/extending existing one. Or why we canât use epub + sigil for example.
I personally *love* Markdown, it is very easy/productive to write documentation in.
But,
- there are different, competing and conflicting Markdown variants - there is no official specification (OK, daring fireball, but he refuses to work with github, stack exchange) - there is no formal syntax specification, nowhere - it is very hard to write a parser, it is too loosely specified
Pier syntax is not new, it is probably older than Markdown.
As far as I am concerned, the most prolific/active authors get to decide, it is a simple as that.
I am just hoping that their standalone parser and document model is high quality ;-)
I have nothing against pier syntax. But imagine person coming from outside, who used markdown to ask questions on stack overflow and write readmes on github, and here he has to use a different syntax for the same purpose. Just a thought about bringing new people into a community :)
I agree with you 100%... plus I use markdown for webdoc => http://files.pharo.org/doc/2.0/