Lab Notebooks
We have been using online lab notebooks since 2007 and the platforms and workflows have certainly changed over the years. Below is a compendium of best practices based on our experience and the particular research we do. This is intended for those in our lab group, however comments and suggestions are welcome.
An online lab notebook is required of all lab members. Entries need to be organized by date and in reverse chronological order.
Notebooks
Person | Notebook | Commitment |
---|---|---|
Steven Roberts | sr320.github.io | |
Sam White | robertslab.github.io | |
Matt George | mattgeorgephd.github.io | |
Aidan Coyle | afcoyle.github.io | |
Olivia Cattau | ocattau.github.io | |
Delaney Lawson | drlawson.github.io | |
Ariana Huffmyer | ahuffmyer.github.io | |
Chris Mantegna | chrismantegna.github.io | |
Zach Bengtsson | zbengt.github.io | |
Larken Root | larkenr.github.io | |
Laura Spencer | laurahspencer.github.io | |
Yaamini Venkataraman | yaaminiv.github.io | |
Grace Crandall | grace-ac.github.io | |
Shelly Trigg | shellytrigg.github.io/notebook |
Platforms
The preferred platform is GitHub. See Laura's Notebook, Steven's Notebook, or Yaamini's Notebook.
Guide to creating a notebook on GitHub:
One way to approach is simply to to follow the instructions at https://github.com/barryclark/jekyll-now. This is what our Notebooks are forks of.
To leverage the modifications Steven has made...
1) Fork his repository associated with his notebook: https://github.com/sr320/sr320.github.io.
Screencast
2) Change the user name associated the repository name in the Settings.
3) Revise the _config.yml
file to include your own personal information
4) Alter lines 30 - 34 of your_username.github.io/_layouts/default.html
to edit the items listed in the Navigation bar at the top right of your rendered webpage. It's useufl to add the following so clicking on "admin" link takes you to your _posts
directory (you'll need to replace `
<a href="https://github.com/<GITHUB-USERNAME>/<GITHUB-USERNAME>.github.io/tree/master/_posts">admin</a>
5) Go to Disqus to set up comments for your website. Pick a page name, ignore instructions on adding code to your site. Complete registration.
6) Go back to _config.yml
file and add your Disqus shortname. This will magically alter code so comments will show up for each posts.
7) All notebook posts have to exist in the _posts
directory and must be formatted in the following fashion (including the .md
extension):
YYYY-MM-DD-<ANYTHING_YOU_want>.md
Note: Sometimes revisions take a few minutes to render on GitHub.
—-
Other options include: - genefish.wordpress.com (ask Steven for an account). See Grace's Notebook
Make sure it is reproducible
Document in a fashion where someone could replicate your work.
Document daily
A record of your work should be published the day of activity. Yep, daily! Even if you feel like you did nothing, post something to describe what you did that day. Did you read some papers? Great! Make a post that lists the papers you read. Did you spend all day searching the web? Also great! Make a post about what you were searching for and how successful you were in finding what you wanted.
Maintain backup
Have a copy of your notebook in another location. This could be done in several ways. - composing in text editor and hosting on GitHub - using IFTTT to post/save entries elsewhere - run script (i.e. wget) to archive contents
Periodically, you will be asked to show where your backup is and demonstrate that it is functional.
All GitHub-based notebooks are also backed up to Gannet: https://gannet.fish.washington.edu/github_backups/notebooks/
Archive
Aidan:
- github.io:
- 2020:
https://github.com/afcoyle/afcoyle.github.io/archive/v2020.zip
- 2020:
Chris:
- gitbhu.io:
Grace:
- github.io:
- 2020:
https://github.com/grace-ac/grace-ac.github.io/archive/v2020.zip
- 2020:
Jay:
- ONS:
- 2018:
https://eagle.fish.washington.edu/trilobite/notebooks/jay.zip
- 2018:
Jake:
- Blogspot:
- 2015:
https://eagle.fish.washington.edu/trilobite/notebooks/jake.zip
- 2015:
Laura:
- github.io:
- 2020:
https://github.com/laurahspencer/LabNotebook/archive/v2021.zip
- 2019:
https://github.com/laurahspencer/LabNotebook/archive/v2019.zip
- 2020:
Matt:
- github.io:
- 2020:
https://github.com/mattgeorgephd/mattgeorgephd.github.io/archive/v2020.zip
- 2020:
Megan:
- github.io:
- 2020:
https://github.com/meganewing/meganewing.github.io/archive/v2020.zip
- 2020:
Olivia:
- github.io:
Sam:
- github.io:
- 2021:
https://github.com/RobertsLab/sams-notebook/archive/refs/tags/v2021.zip
- 2020:
https://github.com/RobertsLab/sams-notebook/archive/v2020.zip
- 2019:
https://github.com/RobertsLab/sams-notebook/archive/v2019.zip
- 2021:
- Jupyter notebooks and R Projects:
- 2021:
https://github.com/RobertsLab/code/archive/refs/tags/v2021.zip
- 2020:
https://github.com/RobertsLab/code/archive/v2020.zip
- 2019:
https://github.com/RobertsLab/code/archive/v2019.zip
- 2021:
Shelly:
- github.io:
- 2020:
https://github.com/shellytrigg/shellytrigg.github.io/archive/v2020.zip
- 2020:
Steven:
- github.io:
- 2020:
https://github.com/sr320/nb-2020/archive/v1.0.zip
- 2019:
https://github.com/RobertsLab/resources/blob/master/archive/sr320.github.io-2019.zip
- 2020:
- ONS:
- 2016:
https://eagle.fish.washington.edu/trilobite/notebooks/steven.zip
- 2016:
Yaamini:
- github.io:
- 2020:
https://github.com/yaaminiv/yaaminiv.github.io/archive/v2020.zip
- 2019:
https://github.com/yaaminiv/yaaminiv.github.io/archive/v2019.zip
- 2020:
Zach:
- github.io: