aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMohammad Akhlaghi <mohammad@akhlaghi.org>2020-04-27 04:26:44 +0100
committerMohammad Akhlaghi <mohammad@akhlaghi.org>2020-04-27 04:26:44 +0100
commit731239dc967fb42e47a91a48a34b9b3e8f2b795f (patch)
tree63c958afe794c37dab56f595419d9799ee3edc40
parentd433c144e95367485be52af8da6416e81c72e3be (diff)
Added a merge/pull request description
Boud had suggested having this on the main page for now, later when we actually add some graphics and structure to the webpage it will be put in the proper place.
-rwxr-xr-xindex.html81
1 files changed, 67 insertions, 14 deletions
diff --git a/index.html b/index.html
index d0d1a1d..f237b55 100755
--- a/index.html
+++ b/index.html
@@ -36,6 +36,13 @@
solutions might not work properly on all mobile browsers.-->
<meta name="viewport"
content="width=device-width, initial-scale=1">
+
+ <!-- Basic styles -->
+ <style>
+ p {margin: 5px 0px 5px 0px;}
+ code {white-space: pre-wrap;}
+ h3 {padding-bottom: 0; margin-bottom: 0;}
+ </style>
</head>
@@ -43,26 +50,72 @@
<!-- Start the main body. -->
<body>
- <h3>!!!Page under construction!!!</h3>
+ <h3>!!!Page under construction!!!</h3>
+ <hr />
+
+ <h2>Maneage: managing data lineage</h2>
+ <p>Maneage is a framework for starting and growing projects, see <a href="pdf/slides-intro.pdf">these slides</a> for an introduction.
+ Through Maneage, the complete data lineage of a project is recorded with its history and can easily be published or archived, enabling <a href="http://akhlaghi.org/reproducible-science.html">exact reproducibility</a>.
+ Maneage is a recipient of the <a href="https://www.rd-alliance.org/node/64603">RDA Europe Adoption grant</a>.
+ </p>
+
+
- <h2>Maneage: managing data lineage</h2>
- <p>Maneage is a framework for starting and growing projects, see <a href="pdf/slides-intro.pdf">these slides</a> for an introduction.
- Through Maneage, the complete data lineage of a project is recorded with its history and can easily be published or archived, enabling <a href="http://akhlaghi.org/reproducible-science.html">exact reproducibility</a>.
- Maneage is a recipient of the <a href="https://www.rd-alliance.org/node/64603">RDA Europe Adoption grant</a>.
- </p>
- <p> To start a new project, simply run these commands to clone it from its <a href="http://git.maneage.org/project.git">Git repository</a>.</p>
- <code style="display: block; white-space: pre-wrap;">git clone https://git.maneage.org/project.git # Clone Maneage, default branch `maneage'.
+
+ <h3>Start building your project in Maneage</h3>
+ <p>
+ To start a new project, simply run these commands to clone it from its <a href="http://git.maneage.org/project.git">Git repository</a>.
+ <code style="display: block; padding-left: 3em">
+git clone https://git.maneage.org/project.git # Clone Maneage, default branch `maneage'.
mv project my-project && cd my-project # Set custom name and enter directory.
git remote rename origin origin-maneage # Rename remote server to use `origin' later.
git checkout -b master # Make new `master' branch, start customizing.</code>
+ </p>
- <p>You are now ready to configure and make the raw template with the commands below.
- If they are successful, you can start customizing it.</p>
-
- <code style="display: block; white-space: pre-wrap;">./project configure # Build all necessary software from source.
+ <p>
+ You are now ready to configure and make the raw template with the commands below.
+ If they are successful, you can start customizing it.
+ <code style="display: block; padding-left: 3em">
+./project configure # Build all necessary software from source.
./project make # Do the analysis (download data, run software on data, build PDF).</code>
-
- <p>See the <a href="https://gitlab.com/maneage/project/-/blob/maneage/README-hacking.md#customization-checklist">Customization Checklist</a> in the cloned <code>README-hacking.md</code> file for the next steps to start customizing Maneage for your project.</p>
+ </p>
+
+ <p>
+ See the <a href="https://gitlab.com/maneage/project/-/blob/maneage/README-hacking.md#customization-checklist">Customization Checklist</a> in the cloned <code>README-hacking.md</code> file for the next steps to start customizing Maneage for your project.</p>
+
+
+
+
+
+ <h3>Merge/Pull requests</h3>
+
+ <p>
+ As you continue customizing Maneage for your own project, you will notice generic improvements that can be useful for other projects too.
+ In such cases, please send us those changes to implement in the core Maneage branch and let them propagate to all projects using it.
+ If you look through the history of the Maneage branch, you'll notice many users have already started doing this, and this is how Maneage is planned to grow.
+ The recommended process is very similar to <a href="https://www.gnu.org/software/gnuastro/manual/html_node/Forking-tutorial.html">this forking tutorial</a>.
+ Here is a summary:
+ </p>
+ <ol>
+ <li>
+ Go to the <code>maneage</code> branch and create a new branch from there like below:
+ <code style="display: block; padding-left: 3em">
+git checkout maneage
+git branch -b my-fix
+ </code>
+ </li>
+ <li>Commit your fix over this new branch.</li>
+ <li>Build a new project on your favorite Git repository (GitLab, BitBucket, or GitHub for example) and assign it to a new Git remote in your project.
+ Let's call it <code>my-remote</code>.
+ You only need to do this once and keep this for future fixes.</li>
+ <li>Push your branch to that remote:
+ <code style="display: block; padding-left: 3em">
+git push my-remote my-fix
+ </code>
+ </li>
+ <li>Submit a link to your fork and the corresponding branch <a href="http://savannah.nongnu.org/support/?func=additem&group=reproduce">on Savannah</a>.
+ If you are <a href="https://savannah.nongnu.org/account/register.php">registered on Savannah</a>, you can also submit it as <a href="https://savannah.nongnu.org/bugs/?func=additem&group=reproduce">a bug</a> or <a href="https://savannah.nongnu.org/task/?func=additem&group=reproduce">a task</a>.</li>
+ </ol>
</body>
</html>