ucsc-ospo / ucsc-ospo.github.io

Website of the Open Source Program Office, UC Santa Cruz

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
• Option B (via git):
  • Fork git repository
  • Create content/project/osre24/ORGANIZATION/PROJECTNAME directory or copy it from previous year's content/project/osre23/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.

Instructions for adding a mentor

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

• Option A: email OSRE administrators
  • Include name, title, affiliations, email, short bio, github profile (if applicable), 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.

Posts, Projects, Authors, Reports, Events

The website has five "lists":

• Posts: (under content/post) include Programs (category: programs) named after their program name, and the OSPO Blog items (category: news) named after their posting date (yyyymmdd) with tags that determine whether news items are also appearing in OSRE News (tag osre) and SoR News (tag sor).
• Projects: (under content/project) are filed in a directory hierarchy with year at the top (e.g. osre22, osre23) and organization for each year. This directory hierarchy avoids name collisions of project names between years and organizations but the website build process does not assign any further meaning to it. Instead, tags determine in which year a project shows up (e.g. tag osre22 or osre23) and whether the project is a UC mentor project (tag uc) or a reproducibility project (tag reproducibility) or both. Additional tags describing project topics are encouraged and show up in the OSRE tag cloud (across all years and organizations).
• Authors (under content/authors) include administrators and OSRE mentors. There are three user_groups: Administration, University of California Mentors, and Summer of Reproducibility Mentors. Authors can belong to more than one group.
• Reports: (under content/report) are authored by OSRE contributors and will appear in the "Student Pages" section on the OSRE page.
• Events: (under content/event) lists the annual symposia (and possibly additional major events). The content/event/_index.md is showing the upcoming event (or the past event if there is no upcoming event yet) and a call-to-action button to register (or to watch the recording of the past event). The list items are past events named by their event date.

How to add a new annual edition of the Open Source Research Experience

To archive the current year (e.g. 2023) and start a new OSRE edition:

• Copy /content/osre to /content/osre23 (/content/osre contains always the newest edition, /content/osre23 is the archived edition)
• Update tags in content/osre projects and reports lists:
  • In content/osre/studentpages.md update tag: [osre24]
  • In content/osre/projects.md update tag: [osre24]
• Update links to previous year and back to new year
  • For Student Pages:
    • In /content/osre/studentpages.md update subtitle: "Go to [last year's student pages](/osre23/#studentpages)"
    • In /content/osre23/studentpages.md update subtitle: "Return to [new student pages](/osre/#studentpages)"
  • For Projects:
    • In /content/osre/projects.md update subtitle: "Go to [last year's projects](/osre23/#projects)"
    • In /content/osre23/projects.md update subtitle: "Go to [2022 projects](/lastosre) or return to [new projects](/osre/#projects)" (2022 projects are under /lastosre because that was still under CROSS. When archiving OSRE 2024, update /content/osre24/projects.md with subtitle: "Go to [2023 projects](/osre23/#projects) or return to [new projects](/osre/#projects)")
  • For Timelines:
    • In /content/osre/timeline.md update subtitle: "Go to [last year's timeline](/osre23/#timeline)"
    • In /content/osre23/timeline.md update subtitle: "Return to [new timeline](/osre/#timeline)"
• Copy /content/report/osre23/ucsc/admin/20221106-admin to /content/report/osre24/ucsc/admin/20231006-admin and update tags in index.md of that directory:
  • Update title to OSRE 2024
  • Replace all osre23 with osre24
• Update /content/osre23/intro.md cta link url: '/osre23/#projects'
• Update /content/osredocs files for mentors, students, and mentor FAQs for OSRE 2024.
• Copy /content/sor to /content/sor23, make 2024 updates to /content/sor, and update SoR links in /content/oser23/osre23.md to /sor23 and vice versa.

Website framework

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

ucsc-ospo.github.io's Issues

link error

• Please take a look at the content/osre24/forstudents.md directory, where the guidelines for students link is not functional. @carlosmalt

Fix typo

Location : Content/osre24/students.md

-> There are several typos in the Students.md file, which make it seem inadequate and affect its overall quality. I wish to work on this issue and solve it as soon as possible. @carlosmalt

Fix broken links in LiveHD project

@renau, Any chance you can fix the broken links in the LiveHD project? Some of the links specific to project ideas seem to point to files that don't exist anymore.

Include minimal contact info in user profiles.

There are multiple mentor profile pages without have any contact information. They should at least include either a link to a homepage or an email address. Otherwise, having a profile page makes no sense from the perspective of a potential contributor. Going through mentor profiles, the following profiles have no contact info:

• Haryadi Gunawi
• Anjus George
• John Bent

Add: Mentors page

How about a mentors page where all the mentors' information is included so that contributors for the following year can get in contact with them?

Details that can be included

• GitHub profile
• Email
• Expertise/Domain
• LinkedIn (If required)

@slieggi & @carlosmalt

What are your thoughts about it?

missing contrirbuting.md file

Hey i think this is amazing repo having a , contributing.md file is amazing for the new contributors like me and other

Add description to polyphy project that covers GSoC work

Currently the language embeddings work of one of the summer students contributing to the polyphy project is not listed as an idea.