Register through Hesburgh Libraries
Offered by the Navari Family Center for Digital Scholarhip.
Learn why it’s important to annotate code, practice commenting in code, and write a README document.
When we write code, it’s important to also write what the code does. By writing good comments that explain our code and completing other documentation such as README files, we can ensure that code is shareable and reusable. Whether you’re revisiting a project you started a while ago, sending your code to your PI, or sharing a project publicly (for example, on a Github repository), code annotation makes things a lot easier.
In this workshop, we will practice annotating code—bring your own, or we will have a language-agnostic example that you can use. Additionally, we will discuss README files: what they are, why they’re important, and how to write them. Participants will come away with best practices for code annotation and a template for README-style documentation. This workshop is open to all, but is targeted to faculty, staff, students, and researchers who are already writing code (in any programming language) and would like to learn more about effectively sharing their work. Please bring a laptop and any code you would like to annotate.
Open to Undergraduates, Faculty, Graduate Students, Staff, Postdocs
Instructed By
Data Services Librarian
smengare@nd.edu
574-631-4481
Summer Mengarelli is the Data Services Librarian in the Navari Family Center for Digital Scholarship. She supports researchers' data needs across the university community and aims to advance data sharing and open research practices. Her interests include open science and data literacy and ethics. She received a Master of Science in Information in Digital Archives, Library Science & Preservation and a Master of Science in Geospatial Data Sciences from the University of Michigan.