Developing Collaborative Documents using GitHub

These resources are forked from the version CC-BY Malvika Sharan – GitHub repository in fork details above, website version at https://malvikasharan.github.io/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

Modifications for eLife Ambassadors

Modifications made from original:

• updated goals
• prepare & adapt 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

About this repository

This repository offers a 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 (reprositories) and maintain the different versions of your documents with information such as which files changes, 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 a wikis and basic task management tools for every project.

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.
• Get set up to contribute repositories and collaborate within the eLife Ambassadors GitHub organisation.

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.

For learners

If you are a learner, you can start Here, and use this [presentation] (link) to guide your learning pace.

Main reference: Friendly GitHub Intro by Kirstie Whitaker

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