You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@deltacloud.apache.org by lu...@apache.org on 2010/10/26 01:29:47 UTC
svn commit: r1027310 - in /incubator/deltacloud/trunk/site: README
content/contribute.haml content/contribute.mdown output/contribute.html
Author: lutter
Date: Mon Oct 25 23:29:47 2010
New Revision: 1027310
URL: http://svn.apache.org/viewvc?rev=1027310&view=rev
Log:
site: incorporate contents of README into content/contribute.mdown
Added:
incubator/deltacloud/trunk/site/content/contribute.mdown
Removed:
incubator/deltacloud/trunk/site/README
incubator/deltacloud/trunk/site/content/contribute.haml
Modified:
incubator/deltacloud/trunk/site/output/contribute.html
Added: incubator/deltacloud/trunk/site/content/contribute.mdown
URL: http://svn.apache.org/viewvc/incubator/deltacloud/trunk/site/content/contribute.mdown?rev=1027310&view=auto
==============================================================================
--- incubator/deltacloud/trunk/site/content/contribute.mdown (added)
+++ incubator/deltacloud/trunk/site/content/contribute.mdown Mon Oct 25 23:29:47 2010
@@ -0,0 +1,90 @@
+---
+title: Deltacloud - Contribute
+extension: html
+filter:
+ - markdown
+ - outline
+---
+Help make Deltacloud better
+===========================
+
+<toc class="toc" numbering="off" toc_style="ul" toc_range="h2-h3" />
+
+All development of Deltacloud takes place in the open. Communication is run
+through the mailing list and all source code changes are tracked publicly.
+
+* <strong>Mailing Lists</strong><br/>
+ For Deltacloud API: <de...@incubator.apache.org>.
+ To subscribe to it, send an email to <de...@incubator.apache.org>. You can also view [Archive][1] in case you are missing something.
+
+ [1]: http://mail-archives.apache.org/mod_mbox/incubator-deltacloud-dev/
+* <strong>IRC</strong><br/>
+ You can also join us on the Freenode IRC channel #deltacloud. Deltacloud
+ developers are generally available on the IRC channel
+* <strong>Bugs</strong><br/>
+ We track bugs in [Apache JIRA][2]. You can [view open bugs][view-bugs] or
+ [file a new one][new-bug] there.
+
+ [2]: https://issues.apache.org/jira/browse/DTACLOUD
+ [view-bugs]: https://issues.apache.org/jira/browse/DTACLOUD
+ [new-bug]: https://issues.apache.org/jira/secure/CreateIssue!default.jspa
+* <strong>Patches</strong><br/>
+ Patches are very welcome. Please send them to the [development
+ list][3]. Patches should be generated with [`git` `format-patch`][4]
+ and sent to the list with [`git` `send-email`][5].
+
+ [3]: http://mail-archives.apache.org/mod_mbox/incubator-deltacloud-dev/
+ [4]: http://kernel.org/pub/software/scm/git/docs/git-format-patch.html
+ [5]: http://kernel.org/pub/software/scm/git/docs/git-send-email.html
+
+Getting the sources
+-------------------
+
+Then Deltacloud Core gives you the API and drivers to various cloud providers.
+It also provides a client library and a commandline interface.
+
+The Deltacloud Core repository is hosted on Apache Incubator.
+Apache uses Subversion, but there is a git mirror available:
+
+ $ mkdir deltacloud
+ $ cd deltacloud
+ $ git clone git://git.apache.org/deltacloud.git core
+
+You can find the Subversion repository at: <https://svn.apache.org/repos/asf/incubator/deltacloud>.
+
+Required packages
+-----------------
+In order to make the Deltacloud components work, you'll need to
+have the following packages installed (on Fedora 12; the names may vary on
+your distro):
+
+ ruby
+ ruby-devel
+ gcc-c++
+ libxml2-devel
+ libxslt-devel
+
+**Note:** these packages are necessary for building all the required ruby gems
+that Deltacloud requires. If you want to install the gems using your system's
+package manager (yum, apt, ports, etc.) you won't need to install these
+packages manually.
+
+Installing the Deltacloud Core
+------------------------------
+
+First, you need to install the server that will give you the Deltacloud API:
+
+ $ cd path/to/deltacloud/core/server
+ $ rake package
+ $ sudo gem install pkg/deltacloud-core-<version>.gem
+
+Then install the client library:
+
+ $ cd path/to/deltacloud/core/client
+ $ rake package
+ $ sudo gem install pkg/deltacloud-client-<version>.gem
+
+Once you have the client installed, run the following command:
+
+ $ cd path/to/deltacloud/core/client
+ $ rake fixtures
Modified: incubator/deltacloud/trunk/site/output/contribute.html
URL: http://svn.apache.org/viewvc/incubator/deltacloud/trunk/site/output/contribute.html?rev=1027310&r1=1027309&r2=1027310&view=diff
==============================================================================
--- incubator/deltacloud/trunk/site/output/contribute.html (original)
+++ incubator/deltacloud/trunk/site/output/contribute.html Mon Oct 25 23:29:47 2010
@@ -43,7 +43,8 @@
<div id='main'>
<div class='container' id='content-deltacloud'>
<h1>Help make Deltacloud better</h1>
- <ul class="toc">
+
+ <p><ul class="toc">
<li>
<a href="#h1">Getting the sources</a>
</li>
@@ -53,32 +54,28 @@
<li>
<a href="#h3">Installing the Deltacloud Core</a>
</li>
- </ul>
- <p>All development of Deltacloud takes place in the open. Communication is run through the mailing list and all source code changes are tracked publicly.</p>
+ </ul></p>
+
+ <p>All development of Deltacloud takes place in the open. Communication is run
+ through the mailing list and all source code changes are tracked publicly.</p>
+
<ul>
- <li>
- <strong>Mailing Lists</strong>
- <br />
- <p>For Deltacloud API: <a href="mailto:deltacloud-dev@incubator.apache.org">deltacloud-dev@incubator.apache.org</a>.
- To subscribe to it, send an email to <a href="mailto:deltacloud-dev-subscribe@incubator.apache.org">deltacloud-dev-subscribe@incubator.apache.org</a>.
- You can also view <a href="http://mail-archives.apache.org/mod_mbox/incubator-deltacloud-dev/">Archive</a> in case you are missing something.</p>
- </li>
- <li>
- <strong>IRC</strong>
- <br />
- <p>You can also join us on the Freenode IRC channel #deltacloud. Deltacloud developers are generally available on the IRC channel</p>
- </li>
- <li>
- <strong>Bugs</strong>
- <br />
- <p>We track bugs in <a href="https://issues.apache.org/jira/browse/DTACLOUD">Apache JIRA</a>. You can <a href="https://issues.apache.org/jira/browse/DTACLOUD">view open bugs</a> or <a href="https://issues.apache.org/jira/secure/CreateIssue!default.jspa">file a new one</a> there.</p>
- </li>
- <li>
- <strong>Patches</strong>
- <br />
- <p>Patches are very welcome. Please send them to the <a href="http://mail-archives.apache.org/mod_mbox/incubator-deltacloud-dev/">development list</a>. Patches should be generated with <a href="http://kernel.org/pub/software/scm/git/docs/git-format-patch.html"><code>git</code> <code>format-patch</code></a> and sent to the list with <a href="http://kernel.org/pub/software/scm/git/docs/git-send-email.html"><code>git</code> <code>send-email</code></a>.</p>
- </li>
+ <li><p><strong>Mailing Lists</strong><br />
+ For Deltacloud API: <a href="mailto:deltacloud-dev@incubator.apache.org">deltacloud-dev@incubator.apache.org</a>.
+ To subscribe to it, send an email to <a href="mailto:deltacloud-dev-subscribe@incubator.apache.org">deltacloud-dev-subscribe@incubator.apache.org</a>. You can also view <a href="http://mail-archives.apache.org/mod_mbox/incubator-deltacloud-dev/">Archive</a> in case you are missing something.</p></li>
+ <li><p><strong>IRC</strong><br />
+ You can also join us on the Freenode IRC channel #deltacloud. Deltacloud
+ developers are generally available on the IRC channel</p></li>
+ <li><p><strong>Bugs</strong><br />
+ We track bugs in <a href="https://issues.apache.org/jira/browse/DTACLOUD">Apache JIRA</a>. You can <a href="https://issues.apache.org/jira/browse/DTACLOUD">view open bugs</a> or
+ <a href="https://issues.apache.org/jira/secure/CreateIssue!default.jspa">file a new one</a> there.</p></li>
+ <li><p><strong>Patches</strong><br />
+ Patches are very welcome. Please send them to the <a href="http://mail-archives.apache.org/mod_mbox/incubator-deltacloud-dev/">development
+ list</a>. Patches should be generated with <a href="http://kernel.org/pub/software/scm/git/docs/git-format-patch.html"><code>git</code> <code>format-patch</code></a>
+ and sent to the list with <a href="http://kernel.org/pub/software/scm/git/docs/git-send-email.html"><code>git</code> <code>send-email</code></a>.</p></li>
</ul>
+
+
<h2 id="h1">Getting the sources</h2>
<p>Then Deltacloud Core gives you the API and drivers to various cloud providers.