RE: [DOCS] feedback

2013-09-04 Thread Radhika Puthiyetath
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-04 Thread sebgoa
l.com] > Sent: Wednesday, September 04, 2013 12:39 PM > To: dev@cloudstack.apache.org > Subject: Re: [DOCS] feedback > > > On Sep 3, 2013, at 7:39 PM, David Nalley wrote: > >> On Mon, Sep 2, 2013 at 11:19 AM, sebgoa wrote: >>> Hi, >>> >>> Aft

RE: [DOCS] feedback

2013-09-04 Thread Radhika Puthiyetath
writer to pick up the new mechanics if the community has already arrived at a consensus about this? Thanks -Radhika -Original Message- From: Sebastien Goasguen [mailto:run...@gmail.com] Sent: Wednesday, September 04, 2013 12:39 PM To: dev@cloudstack.apache.org Subject: Re: [DOCS] feedback

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 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 choice

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 Tracy Phillips
On Tue, Sep 3, 2013 at 8:26 PM, Animesh Chaturvedi < animesh.chaturv...@citrix.com> wrote: > > [Animesh>] Any change should be done post 4.2 > I agree, this should be post 4.2.

Re: [DOCS] feedback

2013-09-04 Thread Sebastien Goasguen
On Sep 3, 2013, at 7:39 PM, David Nalley wrote: > On Mon, Sep 2, 2013 at 11:19 AM, 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 docbook files to markdown and I used a >> stru

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 wrote: > > Hi, > > > > Afte

Re: [DOCS] feedback

2013-09-03 Thread David Nalley
On Mon, Sep 2, 2013 at 11:19 AM, 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 docbook files to markdown and I used a > structure for a book based on 'The little mongodb' book. > We can

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 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... > > > > http://daringf

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#**precode > > No, syntax high

Re: [DOCS] feedback

2013-09-02 Thread Sebastien Goasguen
On Sep 2, 2013, at 4:06 PM, Ian Duffy 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 an issue

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 3:53 PM, Ian Duffy wrote: >> By syntax highlighting do you mean marking 'code sections'? If so then > yes you can... > > http://daringfireball.net/**projects/markdown/syntax#**precode > > No, syntax highlighting isn

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#**precode No, syntax highlighting isn't part of the markdown spec, which is why I asked. Its som

Re: [DOCS] feedback

2013-09-02 Thread Sebastien Goasguen
On Sep 2, 2013, at 3:31 PM, Ian Duffy 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 b

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 the

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.

Re: [DOCS] feedback

2013-09-02 Thread sebgoa
On Sep 2, 2013, at 5:19 PM, sebgoa 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 mongodb' b

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 docboo