Documentation for Rackspace Cloud DNS

[etoews]

No description provided.

[buildhive]

Adrian Cole » jclouds.github.com #15 SUCCESS
This pull request looks good
(what's this?)

[mattstep]

Why do the examples use a combination of ant and maven? This could be simpler.

[mattstep]

This quickstart guide has some general rot in it, you should clean this document up. Terms are off, examples seem overly complex, and there are pre sections that appear untenable.
Please make sure you look through http://www.jclouds.org/documentation/quickstart/rackspace/ instead of just looking at the markdown in github, the xml samples are all broken right now.
@silkysun knows how to fix those.

[etoews]

@silkysun Do you have some suggestions on how to fix the code samples? I've tried the triple backtick thing (e.g. ```xml) but as you can see from http://www.jclouds.org/documentation/quickstart/rackspace/ it doesn't want to work with GitHub pages. The pre sections with the highlight do a proper job of formatting and highlighting the code so it looks good but there's too much space around the sample. Perhaps embedding a gist is the way to go? Thoughts?

Also does BuildHive publish the pages somewhere? I run my docs through jekyll but it doesn't always seem to be one-to-one with what winds up on jclouds.org.

[mattstep]

@everett-toews jekyll works great for me and shows these problems.

[etoews]

Tracking issue for Ant/Maven stuff in jclouds/jclouds-examples#35

[silkysun]

@everett-toews I'm working on this. I should have more for you later this afternoon or tomorrow. Thanks for your patience!

[silkysun]

@everett-toews I apologize for this delayed response. This weekend got very busy for me, and I lost track of time.

Have you tried removing the pre tags around your xml snippets?

Please look at the Maven doc for examples of xml snippets that render correctly. https://raw.github.com/jclouds/jclouds.github.com/master/documentation/userguide/using-maven.md

[etoews]

Will address these comments in separate PRs.

[etoews]

@mattstep Not sure if you noticed but I addressed your comments from this pull request in PR #141 a few days ago.

Switching to Maven was really useful. It also eliminated the need for the XML samples. Thanks for your review. And sorry about the timing of it all. I got pretty sick after I submitted this PR and I should have communicated the fact that I was down and out.

[mattstep]

No worries dude. Thanks for addressing!
On May 19, 2013 3:03 PM, "Everett Toews" notifications@github.com wrote:

@mattstep https://github.com/mattstep Not sure if you noticed but I
addressed your comments from this pull request in PR #141https://github.com/jclouds/jclouds.github.com/issues/141a few days ago.

Switching to Maven was really useful. It also eliminated the need for the
XML samples. Thanks for your review. And sorry about the timing of it all.
I got pretty sick after I submitted this PR and I should have communicated
the fact that I was down and out.

—
Reply to this email directly or view it on GitHubhttps://github.com//pull/134#issuecomment-18125587
.