linzhangcs / Final-Projects

For tracking final projects and documentation

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Final Projects

The Open Source Studio final project, ideally collaborations of 2-3 students, is a contribution to an open source project (or the creation of a new open source project.)

Contributions can be made through a Open-Source-Studio-at-ITP fork (using the process outlined in the data assignment) or to the project directly.

1: Ideas

The first step is to generate a list of possible ideas for contributions (or new projects). Don't worry whether it's an idea that you want to do, you might find something that someone else in the class wants to work on. In addition, this is an exercise in evaluating how open source projects communicate their needs and welcome new contributors.

You can use these lists to search:

You might also try these open source projects that are affiliated with ITP in some capacity:

Also, the projects from the "case studies" or guest speakers are possibilities.

Assignment - Due Oct 23

  1. File at least one GitHub issue with an idea for a contribution (or new open source project). Try to be specific, point to a feature, issue, or elements of the project's documentation.
  2. Respond to at least two other issues with a comment. Is it realistic? Are you interested?

2: Workshop - In class Oct 30

  1. Break into groups of 3 (will be assigned randomly in class).
  2. Pick 2-3 project ideas to workshop from the GitHub issues list (or it could be a new one if you haven't had the chance to post.) Projects can be new open source initiatives or contributions to existing ones.
  3. Divide up the time (you have a total of 30 minutes). For example, if you each pick a project you have 10 minutes for each one. Complete the following "role playing" exercise for each project:
    • One of you is the maintainer: explain the project and where help is needed.
    • The other two of you are contributors and offer ideas for contributions.
    • Then you can have a short discussion, looking at the project's website or GitHub page (if there is one). How do the contributors get started? Is there a Getting Started page, CONTRIBUTING.MD, tutorial, list of issues?
  4. After the above is completed, we will reconvene as a group and share stumbling blocks and next steps for some of the projects.

3: Proposal - Due Nov 6

  1. Using the Proposal Template as a model, write a proposal for your final project. You can create it as a markdown page or use an alternative format like a google doc, blog post, medium post, or publishing platform of your choice.
  2. Pull request a link to your proposal on the proposals page.

4: Project Development

  • TBA

5: Project Documentation and Presentation

  • TBA

About

For tracking final projects and documentation

License:MIT License