Skip to content

Latest commit

 

History

History
152 lines (108 loc) · 14.9 KB

CONTRIBUTING.md

File metadata and controls

152 lines (108 loc) · 14.9 KB

Contribution Guide

Welcome to the CYF Curriculum

We are a volunteer-led community of tech professionals, and we teach people to code for free. We are majority-minority, we welcome everyone, and we welcome you.

This curriculum compiles narratives and activities developed by hundreds of people all over the world. You are invited to join us. Volunteer for the Tech Education team to teach in our classes, or contribute in a number of other ways. You can also volunteer remotely.

Volunteer with CYF

Who runs this?

Our Tech Education volunteers teach in our classes. All Tech Ed volunteers can, and do, develop content for the curriculum, and they are encouraged to experiment to see what works.

The Global Syllabus Team is a group of long term volunteers who are responsible for the overall direction of the curriculum. They decide the strategy and accept new content into the core. Once a Tech Ed volunteer has sufficiently tried out their material, they can propose that it be adopted into the main curriculum, and the Global Syllabus Team will make the ultimate decision. See more info on contributing new content below.

The Global Syllabus Team is led by the Director, currently Sally McGrath. We meet every two weeks to discuss the curriculum and make decisions. The agenda is posted in the Slack channel #cyf-syllabus and the minutes are posted on this website. If you'd like to come and talk to us, please do!

About our content

Our content is:

  • practical
  • written in simple English at a maximum of CEFR B2
  • free

Our content is not:

  • a textbook
  • a reference manual
  • a collection of tutorials

Pedagogy

We broadly use the Teach Tech Together pedagogical framework.

How to contribute

Propose a new narrative or activity

We adopt tested content into the main curriculum, so develop and try out your material first! Come to class, try it, and get feedback from the community. Come talk in #cyf-syllabus-tech on Slack and iterate on your session.

  1. Develop your narrative or activity in a repo. If you're running a workshop, develop in https://github.com/CodeYourFuture/CYF-Workshops. If it's a project, link in https://github.com/CodeYourFuture/CYF-Projects
  2. If you're recording a video, upload it to YouTube and make it public.
  3. Use your material and iterate on it with trainees.
  4. When you're ready to propose adoption, open a PR to this repo.
  5. The Global Tech Ed team will consider your proposal and give you feedback.

We like to experiment. If you have an idea, try it out and let us know how it goes! Keep your experiments small and test them early. (If you want to try something big, like a new module, come talk to us first.)

Our curriculum threads a coherent line through all of this activity, so whatever worlds we explore, we can all come back here and find out what to do next.

Most content we develop and use with classes will not be adopted into the core curriculum -- that's ok! We want to be free to experiment.

Coursework Template


https://github.com/CodeYourFuture/CYF-Coursework-Template

COURSEWORK NAME

Replace this readme with the requirements for your coursework

Learning Objectives

- [ ] Use the [Teach Tech Together](https://teachtogether.tech/en/index.html#s:process-objectives) guide to construct your objectives
- [ ] Limit the objectives to 3-5 items
- [ ] Write objectives you can measure

Requirements

Explain the requirements of the coursework. You might want to talk about goals here. You might want to use formal specifications like Given/When/Then. It's ok for requirements to be in different formats. We want trainees to learn to interpret requirements in many settings and expressions.

Acceptance Criteria

  • I have provided clear success criteria
  • These might be related to the objectives and the requirements
  • I have given some simple, clear ways for trainees to evaluate their work
  • I have run Lighthouse and my Accessibility score is 100

Bugs

If you spot a bug, please let us know by creating an issue or opening a PR with the fix. Bug fixes are super welcome!

As this front end composes many different repos, please open an issue in the repo where you found the bug. If you're not sure, open an issue in this main repo.

(If the content is pulled from another repo, there's a link next to the heading -- follow that link to the source repo and open an issue there.)

Contributors ✨

Thanks goes to these wonderful people (emoji key):


nbogie

📖

Stéphanie Krus

️️️️♿️

Chris Owen

📖

Mike Hayden

🖋

Alasdair Smith

🖋 📖

Jonathan Sharpe

🖋 🚇

rc-pm

📖

Nick Holdsworth

🖋

Tim Hamrouge

🖋

MitchLloyd

👀 ⚠️ 💻

gregdyke

🚇 ⚠️ 🖋 💻

Lucy Zidour

🖋 💻 👀

Alessandro

🖋 💻

Antigoni Makri

🖋 💻

Francesc Rosas

🖋

Sam Martin

🖋 💻

jcholyhead

🖋 💻

Mark Farmiloe

🖋 💻

Máté Szendrő

🖋 💻

Matthew Craven

🐛

Daniel Carter

🐛

Coung

🖋 💻

Lana-Franks-Code

🐛

Gintaras

🐛

rickscode

🐛

Claire Bickley

🖋

Jack Franklin

🐛

Sanyia Saidova

🖋 💻

Jo

🖋 💻

This project follows the all-contributors specification. Contributions of any kind welcome!