Re: Docs

2014-04-08 Thread Sebastien Goasguen
On Apr 8, 2014, at 2:22 PM, Bill Farner wrote: > I'd like to revisit this, since we gain a lot by exposing our docs in more > places (http://docs.cloudstack.apache.org/ is wonderful, we should replicate > that). If this can indeed be automated, it seems like a huge win. I ha

Re: Docs

2014-04-08 Thread Bill Farner
I'd like to revisit this, since we gain a lot by exposing our docs in more places (http://docs.cloudstack.apache.org/ is wonderful, we should replicate that). If this can indeed be automated, it seems like a huge win. I had not heard of pandoc before, it looks awesome! *Sebastien* -

Re: Docs

2014-02-18 Thread Sebastien Goasguen
On Feb 18, 2014, at 9:42 AM, Jake Farrell wrote: > Based on what i've seen in other projects around the ASF I would say that > we should keep the docs on the core website and not external. This will > help the main websites seo and docs that are pushed externally tend to not &g

Re: Docs

2014-02-18 Thread Jake Farrell
Based on what i've seen in other projects around the ASF I would say that we should keep the docs on the core website and not external. This will help the main websites seo and docs that are pushed externally tend to not get updated as much as they are forgotten about. -Jake On Mon, F

Re: Docs

2014-02-17 Thread Sebastien Goasguen
On Feb 17, 2014, at 3:04 PM, Dave Lester wrote: > Sebastien, > > This is great, thank you! > > There were a few bugs in our existing tooling for rendering docs on the > site which has prevented rendering the docs as-is (delayed on part; > although JakeF offered to he

Re: Docs

2014-02-17 Thread Dave Lester
Sebastien, This is great, thank you! There were a few bugs in our existing tooling for rendering docs on the site which has prevented rendering the docs as-is (delayed on part; although JakeF offered to help). I am inclined to switch entirely to what you've contributed here seeing -- wh

Docs

2014-02-17 Thread sebgoa
and it's also used for Apache libcloud. It uses sphinx to organize docs, it's based on restructured text which is fairly close to markdown. It can be built on the fly thanks to a service hook on the github mirror It's hosted by readthedocs. It generates epub, pdf and can manage rel

[jira] [Commented] (AURORA-48) Docs should be named in an SEO-friendly way and rendered on the website

2014-01-21 Thread Dave Lester (JIRA)
uctions on how others can update the site/docs in the future. > Docs should be named in an SEO-friendly way and rendered on the website > --- > > Key: AURORA-48 > URL: https://issues.apa

[jira] [Assigned] (AURORA-48) Docs should be named in an SEO-friendly way and rendered on the website

2014-01-16 Thread Dave Lester (JIRA)
[ https://issues.apache.org/jira/browse/AURORA-48?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ] Dave Lester reassigned AURORA-48: - Assignee: Dave Lester > Docs should be named in an SEO-friendly way and rendered on the webs

[jira] [Created] (AURORA-48) Docs should be named in an SEO-friendly way and rendered on the website

2014-01-16 Thread Kevin Sweeney (JIRA)
Kevin Sweeney created AURORA-48: --- Summary: Docs should be named in an SEO-friendly way and rendered on the website Key: AURORA-48 URL: https://issues.apache.org/jira/browse/AURORA-48 Project: Aurora

[jira] [Resolved] (AURORA-13) howtocontribute page on aurora.i.a.o should reference docs/contributing.md

2014-01-06 Thread Dave Lester (JIRA)
. > howtocontribute page on aurora.i.a.o should reference docs/contributing.md > -- > > Key: AURORA-13 > URL: https://issues.apache.org/jira/browse/AURORA-13 > Project: Auror

[jira] [Commented] (AURORA-13) howtocontribute page on aurora.i.a.o should reference docs/contributing.md

2013-12-30 Thread Jake Farrell (JIRA)
n me committing the patch lets debug why you are having a problem publishing that page and resolve that to avoid future issues. Please ping on irc when you have some time to debug > howtocontribute page on aurora.i.a.o should reference docs/contribu

[jira] [Updated] (AURORA-13) howtocontribute page on aurora.i.a.o should reference docs/contributing.md

2013-12-29 Thread Dave Lester (JIRA)
on aurora.i.a.o should reference docs/contributing.md > -- > > Key: AURORA-13 > URL: https://issues.apache.org/jira/browse/AURORA-13 > Project: Aurora >

[jira] [Created] (AURORA-13) howtocontribute page on aurora.i.a.o should reference docs/contributing.md

2013-12-23 Thread Kevin Sweeney (JIRA)
Kevin Sweeney created AURORA-13: --- Summary: howtocontribute page on aurora.i.a.o should reference docs/contributing.md Key: AURORA-13 URL: https://issues.apache.org/jira/browse/AURORA-13 Project: Aurora