Skip to content

sustainers/academic-map

Repository files navigation

Academic Map

A Jupyter Book of resources for open source in academia

Usage

Go to the website where this is rendered. Currently, that is here. You can also build this locally - see below.

Install

This is a Jupyter notebook, and depends on the tooling system of Jupyter Notebooks to work. Their documentation has an excellent intro to get started. For now:

  • Clone this repository locally.
  • Edit any Markdown locally.
  • Add any pages that you want to be in the Table of Contents to _toc.yml.
  • Run build.sh in order to automatically build the changes. You may need to run chmod +x build.sh to make this executable, first.

Contribute

Please! All contributions are welcome. As is written in the intro page currently:

  • Open an issue to add data. If you are unsure how to use Git easily or you are unsure where something goes, just open an issue with your suggestions or comments.
  • Add a page directly to the Git repository using a Pull Request. The GitHub repo is here. If you have a university, community, or so on, and you know how to use Git and GitHub, please open a PR with the resource!
  • Complain. If this isn't working for you, tell us why, and we'd be more than happy to work to make it better.
  • Join the regular calls. We meet every fourth Thursday. These are announced in the Sustain Discourse.
  • Send an email. Richard Littauer is the main editor for this repository, at the moment, and he's happy to incorporate any changes or to build a more welcoming and inclusive structure for collaboration here if any of the above options is less than ideal. Email richard@sustainoss.org.

Code of Conduct

Please see CODE_OF_CONDUCT.md.

License

MIT.