The Open Source Program Office, UC Santa Cruz

How to add a new project idea to the Open Source Research Experience

Instructions for adding/updating a project

A project serves as the context for one or more project ideas. Each project is represented as a web page with project information and ideas. Projects and their updates are subject to review of the OSRE administrators.

• Option A: email OSRE administrators (currently: Stephanie Lieggi, Carlos Maltzahn)
• Option B (via git):
  • Fork git repository
  • Create content/project/osre23/ORGANIZATION/PROJECTNAME directory or copy it from previous year's content/project/osre22/ORGANIZATION/PROJECTNAME
  • In that directory create/update index.md and the project's image (featured.png or featured.jpg)
  • In index.md fill in the frontmatter (see example):
    • Add the project's title in title:,
    • Date the project entry with date: and lastmod:, using one of the formats 2022-05-27 (day only), 2022-05-27T07:32:00 (with time), 1979-05-27T00:32:00-07:00 (UTC-7 timezone), or 2022-05-27T07:32:00Z (UTC timezone). Note that projects dated in the future will not display.
    • Include a list of authors:, using either names in quotes or user names (see below for instructions on how to add user names)
    • IMPORTANT: set a list of tags that include "osre23" and either "uc" or "reproducibility" or both, depending on whether your project has a mentor affiliated with a UC campus or associated national lab (LBL, LANL, LLNL), or is a Summer of Reproducibility project. Feel free to add additional tags.
    • Below the frontmatter start with a description of the project and include links to the project's webpage.
    • Add each project idea with level-3 header, i.e., ### ... and add a list of essential information that includes topics, skills, difficulty, size (175 vs 350 hours), and mentors.
  • Make a pull request and add @carlosmalt and @slieggi as reviewers.

Instructions for adding a mentor

Mentors are welcome to add information about themselves (see example):

• Option A: email OSRE administrators (currently: Stephanie Lieggi, Carlos Maltzahn)
  • Include name, title, affiliations, email, short bio, whether you are UC or Summer of Reproducibility mentor (or both), and, optionally, photo, web page and social media links.
• Option B (via git):
  • Fork git repository (or combine with pull request of adding/updating a project above)
  • Create /content/authors/USER directory.
  • In that directory copy an _index.md file from another user and update it (see example)
    • Many icons are available (see documentation)
    • IMPORTANT: Under user_groups: add either - University of California Mentors or - Summer of Reproducibility Mentors (or both).
    • The bio and any other information goes below the frontmatter.

Website framework

This website is based on Wowchemy, a website framework using Hugo that can be deployed with GitHub and Netlify. The theme of the OSPO website is the Research Group Theme.