Lab manual

Welcome to the Rendeiro Lab Manual.

This manual provides comprehensive information about the lab's culture, procedures, and workflows to ensure a collaborative and efficient research environment.

The manual is hosted in the lab-manual repository on GitHub. It is written in Markdown and can be converted to HTML and PDF using Pandoc.

This manual is open source and maintained collaboratively. Anyone on GitHub can propose changes.

Editing the manual

To contribute an adition or change to the manual:

1. Edit or create files directly on GitHub, or locally on your computer.
2. Submit a pull request with a clear, one-line description of the changes made.
3. Follow best practices by adding reviewers and referencing related issues, if applicable.

Tip: to add a table of contents to a new file document, use mdformat-toc. Insert <!-- mdformat-toc start --> where the table of contents should appear, and run mdformat <file.md> on the edited file, or make format to format all.

Building the manual locally

To preview changes locally before committing to Github and deploying on the lab website, you can build the manual locally using the provided tools. Ensure you have the necessary dependencies installed:

• Pandoc
• wkhtmltopdf

To streamline the development process the project includes a Makefile. Key targets include:

• format: Formats Markdown files consistently using mdformat.
• build: Converts the manual into a single HTML file using pandoc and generates a PDF file using wkhtmltopdf.
• clean: Removes generated files to ensure a fresh build.

Styling for the manual is controlled by a custom CSS file, which ensures a nice appearance in both HTML and PDF formats.

Acknowledgements

We thank the following labs for sharing their open-source lab manuals, which inspired this project:

• Aly Lab Manual
• Getz Lab Manual