I would like to see the following in your final project repository:
One or more (Bash/Python/R) scripts with a significant amount code. [4]
The scripts do not yet need to be complete or functioning, but make sure I can understand what you are trying to do. Also, it should be clear what the general purpose of the scripts is.
You can earn as many points with clarity of purpose and documentation (use comments!) as with the code itself.
An overview of all the scripts you envision writing, and their functions. [3]
This is essentially a more worked-out version of the technical description you wrote in your proposal (some remaining uncertainties are fine!).
Having learned about Snakemake, you should include how you want to implement being able to (re)run the entire pipeline/workflow: with Snakemake, or a Bash or Python script.
A to-do list. [1.5]
This could be a separate list or it could be (partially) integrated with the overview of scripts mentioned above.
Both the technical description and the to-do list would be suitable for the main README.md
of the project (and it would be good to continue to update these later on). But you could also create separate documents for each, whatever works better for you.
I will also start looking at your Git commits and associated commit messages. [1.5]
I will not grade this harshly, and will just skim you commit history, but will subtract points if:
Your commits do not form logical units at all – especially if they include work on multiple unrelated items. (“Oversplitting” of commits, i.e. having some really small commits that are not as much of a problem, that just tends to happen unless you amend commits.)
Your commit messages are consistently uninformative (“Update file X” is generally not enough – especially when repeated).
You can also flag specific things that you would like feedback/advice on, perhaps best in the GitHub Issue mentioned below.
Once again, tag me (@jelmerp
) in an “Issue” on GitHub and make sure you point me to the places you want me to look, particularly if you have a lot going on (in such cases, I won’t grade files that you don’t point me to).
Some of you already had most of these pieces in place in your repository when I looked at your proposal. If that is the case, just point me where to look – you don’t necessarily need to restructure things for this checkpoint.
Remember that I have added some topic overviews to the GitHub site that should be helpful as you work on you final project – see the top navigation bar.
Text and figures are licensed under Creative Commons Attribution CC BY 4.0. The figures that have been reused from other sources don't fall under this license and can be recognized by a note in their caption: "Figure from ...".