Hi!
Thanks for your ideas, David. I found them very useful. So I've made a
new version of a site map basic structure. Please, see the attachment
and let me know what you think.
--
Dagmar Husarova
Intern | Red Hat. Inc.
'Home'
News
Deltacloud gives you (main points, what deltacloud is and what can you
get)
Learn more (link to 'About')
'Run the Deltacloud server' (link to 'Run the API')
'Use Deltacloud' (link to 'Use the API')
'Contribute to Deltacloud' (link to 'Contribute')
'Report a bug' (In my opinion it should be here. If someone finds a
bug, he or she needs to quick way to find out, where to report)
'About' (more details about Deltacloud priniciples, advantages etc. There could
be some scheme with detailed description.)
'Run the Deltacloud server' (link to 'Run the API')
'Use Deltacloud' (link to 'Use the API')
'Contribute to Deltacloud' (link to 'Contribute')
Run the API
Installation of Deltacloud itself
Running the Deltacloud server (quick start guide)
Use the API
How to use API, install instructions for clients
Contribute
there could be a box titled 'How can I contribute?' with links:
'Send a patch'
'Write a provider driver'
'Write and run a test'
'Report bug'
Besides that it should contain a link to 'Getting the sources' and a short
text about using the Deltacloud github mirror and a license agreement.
'Getting the sources' and dependencies contains these sections:
Development dependencies
Getting the sources
Building from a source and installing Deltacloud gem
and a text: For quick orientation in Deltacloud directory see
the 'Overview of the Deltacloud directory structure'. (link to a list of the
most important parts of Deltacloud directory with their paths)
'API Documentation' (As I see it, this is a source of complex information about
API interesting and relevant mainly for developers. I think it should stay
separated from 'Contribute' page and 'Use the API' page. It seems to me easier
this way. If someone needs to see the documentation, it's right there on the
top of the page as well as the link to 'Contribute' page. It would be much
harder to find what you are looking for if these two were hidden in another
link.)
'REST API'
'Drivers'
'Clients'
'The Deltacloud Ruby Client'
'Other HTTP Clients'
'libdeltacloud'
'Contact'
'mailing list'
'irc channel'
'Teambox'
