Re: [DOCS] feedback

2013-09-04 Thread Sebastien Goasguen
On Sep 3, 2013, at 7:39 PM, David Nalley da...@gnsa.us wrote: On Mon, Sep 2, 2013 at 11:19 AM, sebgoa run...@gmail.com wrote: Hi, After seeing lots of frustrated people with folks I decided to try something out with markdown. I used pandoc to convert some docbook files to markdown and

Re: [DOCS] feedback

2013-09-04 Thread Tracy Phillips
I really like markdown, very readable in the state that it is in before it is converted to whatever else. I also like reStructuredText. Outputting to different formats is important I guess, however, I would say that most real reading that is done is done in html. With that said, I love beautiful

Re: [DOCS] feedback

2013-09-04 Thread Chip Childers
On Wed, Sep 04, 2013 at 12:26:36AM +, Animesh Chaturvedi wrote: [Animesh] Any change should be done post 4.2 Actually, now's the time IMO. Master is the 4.3 target at this point, so shouldn't we make larger changes now? (moving docs to their own repo and re-designing any tooling choices

Re: [DOCS] feedback

2013-09-04 Thread Travis Graham
I agree on splitting the docs out into their own repo that pull requests can be sent to as bugs in the docs are found or different installations are tested and documented. With the current state of the docs being one of the greatest barriers to entry for new CloudStackers, or even when running

Re: [DOCS] feedback

2013-09-04 Thread sebgoa
12:39 PM To: dev@cloudstack.apache.org Subject: Re: [DOCS] feedback On Sep 3, 2013, at 7:39 PM, David Nalley da...@gnsa.us wrote: On Mon, Sep 2, 2013 at 11:19 AM, sebgoa run...@gmail.com wrote: Hi, After seeing lots of frustrated people with folks I decided to try something out

RE: [DOCS] feedback

2013-09-04 Thread Radhika Puthiyetath
it as a project, define deadlines, and deliver one at a time. Any suggestions? Regards -Radhika -Original Message- From: sebgoa [mailto:run...@gmail.com] Sent: Wednesday, September 04, 2013 9:10 PM To: dev@cloudstack.apache.org Subject: Re: [DOCS] feedback On Sep 4, 2013, at 4:43 PM

Re: [DOCS] feedback

2013-09-03 Thread Prasanna Santhanam
On Mon, Sep 02, 2013 at 08:53:37PM +0100, Ian Duffy wrote: By syntax highlighting do you mean marking 'code sections'? If so then yes you can... http://daringfireball.net/**projects/markdown/syntax#**precodehttp://daringfireball.net/projects/markdown/syntax#precode No, syntax highlighting

Re: [DOCS] feedback

2013-09-03 Thread Tracy Phillips
Kudos to you Sebastian! I am glad to see it in Markdown. On Tue, Sep 3, 2013 at 3:09 AM, Prasanna Santhanam t...@apache.org wrote: On Mon, Sep 02, 2013 at 08:53:37PM +0100, Ian Duffy wrote: By syntax highlighting do you mean marking 'code sections'? If so then yes you can...

Re: [DOCS] feedback

2013-09-03 Thread David Nalley
On Mon, Sep 2, 2013 at 11:19 AM, sebgoa run...@gmail.com wrote: Hi, After seeing lots of frustrated people with folks I decided to try something out with markdown. I used pandoc to convert some docbook files to markdown and I used a structure for a book based on 'The little mongodb' book.

RE: [DOCS] feedback

2013-09-03 Thread Animesh Chaturvedi
-Original Message- From: David Nalley [mailto:da...@gnsa.us] Sent: Tuesday, September 03, 2013 4:40 PM To: dev@cloudstack.apache.org Subject: Re: [DOCS] feedback On Mon, Sep 2, 2013 at 11:19 AM, sebgoa run...@gmail.com wrote: Hi, After seeing lots of frustrated people

[DOCS] feedback

2013-09-02 Thread sebgoa
Hi, After seeing lots of frustrated people with folks I decided to try something out with markdown. I used pandoc to convert some docbook files to markdown and I used a structure for a book based on 'The little mongodb' book. We can generate epub and pdf using latex. See:

Re: [DOCS] feedback

2013-09-02 Thread Alexander Hitchins
Thanks Sebastien, I will read these tonight. I'm a big fan of Markdown and am using it for all my notes and docs. Alex On 9/2/2013 4:19 PM, sebgoa wrote: Hi, After seeing lots of frustrated people with folks I decided to try something out with markdown. I used pandoc to convert some

Re: [DOCS] feedback

2013-09-02 Thread sebgoa
On Sep 2, 2013, at 5:19 PM, sebgoa run...@gmail.com wrote: Hi, After seeing lots of frustrated people with folks I decided to try something out with markdown. s/folks/docs I used pandoc to convert some docbook files to markdown and I used a structure for a book based on 'The little

Re: [DOCS] feedback

2013-09-02 Thread Ian Duffy
Love the idea of using markdown! Much easier to write then docbook. Any idea if it supports the syntax highlighting markdown features github offer? e.g. ```shell #!/bin/bash echo hello world ``` Had some slight issues building on OSX due to me missing the font used and certain laTeX plugins. I

Re: [DOCS] feedback

2013-09-02 Thread Alexander Hitchins
By syntax highlighting do you mean marking 'code sections'? If so then yes you can... http://daringfireball.net/projects/markdown/syntax#precode Alex Hitchins On 9/2/2013 8:31 PM, Ian Duffy wrote: Love the idea of using markdown! Much easier to write then docbook. Any idea if it supports

Re: [DOCS] feedback

2013-09-02 Thread Sebastien Goasguen
On Sep 2, 2013, at 3:31 PM, Ian Duffy i...@ianduffy.ie wrote: Love the idea of using markdown! Much easier to write then docbook. Any idea if it supports the syntax highlighting markdown features github offer? e.g. ```shell #!/bin/bash echo hello world ``` Had some slight issues

Re: [DOCS] feedback

2013-09-02 Thread Ian Duffy
By syntax highlighting do you mean marking 'code sections'? If so then yes you can... http://daringfireball.net/**projects/markdown/syntax#**precodehttp://daringfireball.net/projects/markdown/syntax#precode No, syntax highlighting isn't part of the markdown spec, which is why I asked. Its

Re: [DOCS] feedback

2013-09-02 Thread Sebastien Goasguen
On Sep 2, 2013, at 3:53 PM, Ian Duffy i...@ianduffy.ie wrote: By syntax highlighting do you mean marking 'code sections'? If so then yes you can... http://daringfireball.net/**projects/markdown/syntax#**precodehttp://daringfireball.net/projects/markdown/syntax#precode No, syntax

Re: [DOCS] feedback

2013-09-02 Thread Ian Duffy
yes please, I had issues with missing fonts... First issue was font, I was missing Consolas. Grabbed it from here http://www.fontpalace.com/font-details/Consolas/ and just installed using the fonts manager in OSX. Then I hit an issue with sectsty.sty not being found. Thankfully the tex package

Re: [DOCS] feedback

2013-09-02 Thread Sebastien Goasguen
On Sep 2, 2013, at 4:06 PM, Ian Duffy i...@ianduffy.ie wrote: yes please, I had issues with missing fonts... First issue was font, I was missing Consolas. Grabbed it from here http://www.fontpalace.com/font-details/Consolas/ and just installed using the fonts manager in OSX. Then I hit