GitHub for Documents

This tutorial is for new GitHub users to understand main features and how to use them for developing documents collaboratively

This project is maintained by malvikasharan

DOI

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

For the instructors

  1. Define the goal for this project.
  2. Decide on the date, time, and venue for this course.
  3. Define your target audience and their requirements.
  4. Create a README file and add the information there.
  5. 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

  1. Collaboration, Version Control, and GitHub
  2. Getting to know GitHub
  3. Github for collaboration