[Commits] [svn:einsteintoolkit] www/info/contribute/ (Rev. 343)

gallen at cct.lsu.edu gallen at cct.lsu.edu
Thu Oct 28 02:43:49 CDT 2010


User: gallen
Date: 2010/10/28 02:43 AM

Modified:
 /info/contribute/
  index.php

Log:
 New contribution procedure

File Changes:

Directory: /info/contribute/
============================

File [modified]: index.php
Delta lines: +73 -2
===================================================================
--- info/contribute/index.php	2010-10-19 19:40:25 UTC (rev 342)
+++ info/contribute/index.php	2010-10-28 07:43:48 UTC (rev 343)
@@ -1,10 +1,81 @@
 <?php $title='Contribute to the Toolkit';
 include_once($_SERVER['DOCUMENT_ROOT'].'/global/header.php');?>
 
+<p>The Einstein Toolkit consists of diverse software components contributed by many <a href="../../credits">different people</a>. 
+The consortium welcomes all contributions to the toolkit including bug reports, feature requests, patches, to documentation and software. This page 
+  describes our general philosophy for software contributions and the mechanism for providing software. Please use the <a href="https://trac.einsteintoolkit.org/wiki">bug tracking system</a> for bugs, issues or wish list items, and email any questions to the <a href="mailto:users at einsteintoolkit.org">users</a> mail list.</p>
 
-<p>We welcome contributions of bug reports, feature requests, patches, documentation and codes (including Cactus thorns) to the Einstein Toolkit. We are still coming up with appropriate mechanisms and policies for this, but for now please email the <a href="mailto:users at einsteintoolkit.org">users</a> mail list, or use the <a href="https://trac.einsteintoolkit.org/wiki">bug tracking system</a> for bugs, issues or wish list items.</p>
 
-<p>Please note our <a href="/about/licenses/">software licensing</a> policy for the Einstein Toolkit.</p>
 
+</p>A  driving principle of the Einstein Toolkit is that it should be directly and reliably useful for research
+  and education. This requirement involves much more than simply making software available for download, 
+and we have the following requirements for software:</p>
 
+<ul>
+  <li> Components should be of sufficient quality to be used for peer-reviewed and published science. This includes a basic standard of software engineering, 
+  documentation of the software including algorithms and methods, tutorials and examples, and self-tests to demonstrate 
+that the software works correctly. 
+
+  <li> To focus development and support, optimize resources, and provide best practises, the Einstein Toolkit components should be of current interest to the community.
+
+<li>All components must be distributed under an  <a href="/about/licenses/">open source licence</a> so that others can use these
+components without restrictions (except as mandated by scientific integrity), can modify and improve them as necessary, and can pass on
+these modifications to their collaborators as they see fit.</li>
+
+</ul>
+
+<p>Note that the Einstein Toolkit is not aiming to provide a single implementation. The 
+  inclusion of alternative components providing the same or similar functionality is welcomed. Further, software does not have to use or be associated with either Cactus or 
+3D time evolutions. On the contrary, we would love to have tools for
+ pre- and post-processing simulation data, 1D or 2D simulation codes,
+ or visualisation helpers.
+</p>
+
+
+<h2>How to Contribute New Software Components</h2>
+
+<p>New software components need to satisfy the general requirements listed above. In addition, a few measures are necessary
+  to allow for effective integration, use, and support:</p>
+
+<ul>
+
+<li>Components can  be hosted in repositories at
+ einsteintoolkit.org, or can be hosted elsewhere. If hosted at einsteintoolkit.org the authors 
+ specify who will have write permissions to the repository. If hosted
+ elsewhere, components must be reliably and conveniently publicly
+ accessible. If a server becomes permanently unavailable, they must
+ be moved (e.g. to einsteintoolkit.org) to remain accessible.
+
+<li>Several times a year, a new version of the Einstein Toolkit will be released.
+ These releases consist of snapshots of all components and releases need to be 
+ coordinated for example to ensure  
+  that examples and test cases are up to date, to create tags
+ or branches, and to avoid disruptive changes during the release
+ process.
+
+<li> Einstein Toolkit components are developed in an open manner. This means that
+ changes to a component should not surprise the community, and that
+ patches or corrections requested by the Einstein Toolkit maintainers should be
+ considered in a timely manner. 
+
+</ul>
+
+<p>
+The current working procedure for contributions is:
+</p>
+
+<ol>
+  <li> Author(s) contacts the Einstein Toolkit consortium (e.g. through the users or maintainers mail lists) 
+       about software that they intend to contribute
+  <li> Discussions take place between the maintainers and author(s) to discuss issues above.
+  <li> If software will be hosted by the Einstein Toolkit it is put into an "incoming" repository.
+  <li> The maintainers review the software, and present their recommendation to the whole Consortium to decide 
+if the software becomes a component of the development version of
+        the toolkit. 
+  <li> At the next release, the component is released as part of the toolkit. Credits for the Einstein Toolkit are updated to reflect any additional contributors.
+</ol>
+
+
+
+
 <?php include_once($_SERVER['DOCUMENT_ROOT'].'/global/footer.php');?>



More information about the Commits mailing list