Collaborating and Publishing on the Web with GitHub
January 11, 2022 · View on GitHub
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-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 missingrevert-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