Lab Docs
This resource provides documentation for general wet lab and dry lab organization and pipelines for the Zamanian Lab at the University of Wisconsin-Madison. This is an evolving resource.
How to Use this Guide
New lab members should first orient themselves with our Lab Manual and Computational Onboarding documents. All finalized lab protocols are maintained on the Protocols page. Lab Sheets provides links to important Google sheets that are maintained by the laboratory. Pipelines provides more detailed information on how to run established computational (e.g., phenotyping and sequencing) pipelines locally or using available servers. This resource complements and describes our use of other systems in place for lab organization and management (i.e., Quartzy, Benchling, and Box).
Updating
This resource is by nature an open, living, and collaborative document. We are using MkDocs as our site generator which uses a simply structured GitHub repository that includes Markdown files as the documentation and a few ancillary files to help in generation. You will need to have your own GitHub account and will need to be a member of the @zamanianlab organization in order to gain editing privileges. To edit this document, please follow the instructions below.
-
Install MkDocs and the Material theme
conda install -c conda-forge mkdocs=1.1.2
conda install -c conda-forge mkdocs-material=6.1.7
conda install -c conda-forge mkdocs-material-extensions=1.0.1
-
Clone the ZamanianLabDocs repo:
git clone https://github.com/zamanianlab/ZamanianLabDocs.git
-
Create and edit a Markdown file
- Use previous documentation as a guide
- Save in
/docs/
with the.md
extension- NOTE: if adding/editing a protocol, make a new folder
/docs/protocols
titled{protocol_name}
(without the {}); if adding images, make a new folder calledimg
in/docs/protocols/{protocol_name}
- NOTE: if adding/editing a protocol, make a new folder
- Use the cheatsheet for reference
- Use an online editor (like this one) or use Atom combined with the Markdown Preview Plus extension
-
Push to GitHub
-
Build and deploy site
mkdocs build && mkdocs gh-deploy
-
Optional: before deploying with
gh-deploy
, view the site locally withmkdocs serve
and copy/paste https://127.0.0.1:8000/ into your browser -
After deploying, check to ensure everything deployed as expected by visiting https://www.zamanianlab.org/ZamanianLabDocs/