Maneage is a framework for having full control over a project's data lineage (thus producing a reproducible result). Maneage is a recipient of the RDA Europe Adoption grant. To learn more about its founding criteria and a basic introduction, see Akhlaghi et al. (2020, arXiv:2006.03018), watch this talk (on YouTube, an invited talk at RDA Adoption week 2020), or see these slides.
To start a new project, simply run these commands to clone it from its Git repository.
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.
You are now ready to configure and make the raw template with the commands below. If they are successful, you can start customizing it.
./project configure # Build all necessary software from source. ./project make # Do the analysis (download data, run software on data, build PDF).
See the Customization Checklist in the cloned
README-hacking.md file for the next steps to start customizing Maneage for your project.
Development discussions (like list of existing bugs and tasks) are currently maintained in GNU Savannah. You can register in GNU Savannah to submit a bug or submit a task, or comment on an existing bug or task. If you want to submit a general issue without registering on Savannah, you can submit an item.
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 this forking tutorial. Here is a summary:
maneagebranch and create a new branch from there like below:
git checkout maneage git branch -b my-fix
my-remote. You only need to do this once and keep this for future fixes.
git push my-remote my-fix