Home

Welcome to Ada's Core-Unit-1 Wiki!

This repo is where Unit 1 of Ada's new Python curriculum will live.

The Team

• Merge Magicians: @Simon and @Audrey
• Kanboard Maintainee: @Audrey
• Reviewees: (list staff here)

The Curriculum

The new Python curriculum will be consumed by students through the Learn platform and will be split into 3 different units, each having its own repository.

• Unit 1: https://github.com/Ada-Developers-Academy/core-unit-1/wiki/_new
• Unit 2 & 3 (coming soon)

Units are made up of several topics which are broken down further into lessons. Each topic contains one or more lessons that dive deeper into different parts of the topic. For example, functions is split into 3 different lessons: intro to functions, invoking functions, and defining functions.

Simon will produce PRs based on a topic. Reviewees will then produce batch reviews on lessons inside of PRs.

Primary Committee Resources

• Project Board
• Pull Requests
• Issues
• Review Commit Code of Conduct and Expectations Guide
• Slack.

Project Board

The project board displays all work contributed to curriculum development that will be managed by Audrey. It is split into 5 different columns:

• In Development: describes lessons in PR that are still in the writing/brainstorming stage that could use a suggestion or two.
• Ready for Review: PR consisting of lessons ready to be reviewed.
• In Review: PR currently being reviewed. Refer to the assignee photo to see who the reviewer is. In order to move onto the next step, two reviewers must approve the PR for changes to be merged.
• Needs Magician Review: The last step before merging into Main. Simon or Audrey will discuss reviews and/or merge in changes.
• In Main: PRs merged into main

How to Contribute

Committee members will edit PRs containing lessons. Members are free to edit towards their interests and according to their time commitment.

There are 3 roles reviewers can take for each PR:

• Editor: Proofreads, expands on explanations, wordsmith, sensitivity/respects, and honors Adies.
• Question curators: Creates questions based on learning goals and content in the lesson. Great for members short on time but looking to make a great impact.
• Visual curators: Great for the visually inclined, dev twitter addicts, lovers of code snippets, designs, diagrams, or has a relevant picture/meme saved for YEARS that they're excited to share.

Note: Roles are NOT restrictive, one member can take on all 1 or all roles for a PR as long as they assign themselves to the relevant PR and issues.

To start reviewing curriculum:

• Step 1: Browse the cards in the project board and issues, and choose your role.

  • Editors: Go to Project board and look for PRs in ‘Ready for Reviews’ and ‘In Review’ and assign yourself as ‘Reviewers’.
  • Question Curators: Look in Issues for creating Learn challenges for a lesson and assign yourself to this card.
  • Visual Curators: Look in Issues for adding Visuals for a lesson and assign yourself to this card.

• Step 2: Review Work

  • Editors: Make as many comments and suggestions as you’d like. Once you are finished, please add a comment to the batch review and mark as:
    • ‘Approve’ - the lesson looks mostly great and ready for Simon and Audrey to review.
    • ‘Request Changes’ - If the lesson needs a complete rewrite and further discussion is required, Simon and I will take a look.
  • Question Curators: Add your Learn questions as a ‘comment’ in pull request batch review. Move card from ‘In Development’ to ‘Ready for Magician Review’.
  • Visual Curators: Add visuals as a ‘comment’ in PR batch review. Move card from ‘In Development’ to ‘Ready for Magician Review’.