Skip to content

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 GitHub last commit
Sam White robertslab.github.io GitHub last commit
Matt George mattgeorgephd.github.io GitHub last commit
Aidan Coyle afcoyle.github.io GitHub last commit
Olivia Cattau ocattau.github.io GitHub last commit
Delaney Lawson drlawson.github.io GitHub last commit
Ariana Huffmyer ahuffmyer.github.io GitHub last commit
Chris Mantegna chrismantegna.github.io Github last commit
Zach Bengtsson zbengt.github.io Github last commit
Larken Root larkenr.github.io Github last commit
Laura Spencer laurahspencer.github.io GitHub followers
Yaamini Venkataraman yaaminiv.github.io GitHub followers
Grace Crandall grace-ac.github.io GitHub followers
Shelly Trigg shellytrigg.github.io/notebook GitHub followers

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 ` with your own info):

<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

Chris:

  • gitbhu.io:

Grace:

  • github.io:
    • 2020: https://github.com/grace-ac/grace-ac.github.io/archive/v2020.zip

Jay:

  • ONS:
    • 2018: https://eagle.fish.washington.edu/trilobite/notebooks/jay.zip

Jake:

  • Blogspot:
    • 2015: https://eagle.fish.washington.edu/trilobite/notebooks/jake.zip

Laura:

  • github.io:
    • 2020: https://github.com/laurahspencer/LabNotebook/archive/v2021.zip
    • 2019: https://github.com/laurahspencer/LabNotebook/archive/v2019.zip

Matt:

  • github.io:
    • 2020: https://github.com/mattgeorgephd/mattgeorgephd.github.io/archive/v2020.zip

Megan:

  • github.io:
    • 2020: https://github.com/meganewing/meganewing.github.io/archive/v2020.zip

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
  • 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

Shelly:

  • github.io:
    • 2020: https://github.com/shellytrigg/shellytrigg.github.io/archive/v2020.zip

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
  • ONS:
    • 2016: https://eagle.fish.washington.edu/trilobite/notebooks/steven.zip

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

Zach:

  • github.io: