Collaborating and Publishing on the Web with GitHub – Workshop

About

Material initially developed by lexnederbragt for a workshop on "Writing and publishing on the web together using Github".

I have taught this workshop a couple of times now, and it has become clear what works well and what could be improved. It is still – and will be for some time – a work in progress.

For now, the lesson material includes:

• an outline of the workshop
• an overview of learning outcomes
• the background story for the version control and collaboration part
• a not yet complete list of all external links
• a not yet complete list of references to further reading and useful links

You are welcome to contribute! This call goes out especially to the participants of my workshops – contributing to repositories on GitHub helps you stay 'on track' and getting comfortable working on GitHub. It's fun, too! :)

Workshops

Upcoming

Date	Place	Institution	Language

Past

Date	Place	Institution	Language
2021-11-03	Oslo	The University of Oslo	ENG
2021-10-20	Oslo	The University of Oslo	NOB
2020-01-17	Oslo	The University of Oslo	ENG
2019-09-11	Oslo	The University of Oslo	ENG
2019-04-10	Oslo	University of Oslo	ENG
2019-03-25	Mainz	DHd2019 International Conference	GER
2019-01-18	Oslo	The National Library of Norway	NOB
2018-12-12	Oslo	The National Library of Norway	NOB
2018-11-01	Trondheim	NTNU Gunnerus Library	ENG
2017-12-08	Oslo	The University of Oslo	ENG

Development Plan

• Overhaul lesson, especially cutting out "exercises" in the middle part (collaboration) to make more room for Fork, Issues, and troubleshooting, especially for the missing revert-function on GitHub
• Find a better / different example than the Guacamole recipe. To-Do-List for a project? Historical recipe for scrambled eggs
• Translate lesson into Norwegian and German
• Create a reference for technical terms (fork from Software Carpentry Git lesson?)
• Create a further reading list with links to GitHub handbook, git documentation, markdown cheat sheet etc.
• Create a little add-on with info on how to set up local versioning either with git via command line, with GitHub Desktop and with integrated git in editors like Visual Studio and Atom etc.
• Create another little add-on with info about smartphone and tablet apps for integrating GitHub (like CodeHub)
• Show that GitHub repositories can be assigned a DOI via Zenodo.org – especially relevant for finished projects
• Add info on Licences, especially CC-Licences