Developing Collaborative Document

References used in this course are taken from Mozilla Science Lab’s Study Group Orientation and Kirstie Whitaker’s presentation on Friendly GitHub Intro:

Please use this presentation to guide your workshop

About this repository

This repository offers learning material for a practical session on “Developing Collaborative document”, which will introduce you to GitHub as a tool for creating documents online with your collaborators.

GitHub provides a Web-based graphical interface to maintain and share your projects (repositories) and maintain the different versions of your documents with information such as which files change, what changed, who changed them, and why those updates were made.

GitHub also provides access control (who can access your files, who can read or edit them) and several collaboration features, such as wikis and basic task management tools for every project.

For learners

If you are a learner, you can start Here.

Please, use this presentation to guide your learning pace.

Prerequisite

No prior experience with GitHub is needed. Bring any real-life scenario, where developing collaborative documents will be useful for you. Please bring your laptop to this event.

Learning outcome

The goal is to make you comfortable with a Collaborative workflow in the GitHub interface.
Practice adding resources to online project folders, working with tasks and issues, writing messages when committing to any change, making and reviewing change requests from others, and merging them.
You’ll also practice good communication with contributors.

For the instructors

Define the goal for this project.
Decide on the date, time, and venue for this course.
Define your target audience and their requirements.
Create a README file and add the information there.
Create handout material covering the following areas:
- Collaboration and version control (versioning)
- GitHub
- GitHub folder/project is also known as repository/repo
- Creating a repo
- Playing around with the repo
- Collaborating with others
- Useful GitHub features

Main reference: Friendly GitHub Intro by Kirstie Whitaker