diff --git a/README.md b/README.md index 60ddf021..ddd78a53 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,42 @@ -# The Carpentries Workbench Template R Markdown Lesson +# Geospatial Data Carpentry for Urbanism This lesson is a template lesson that uses [The Carpentries Workbench][workbench]. -## Create a new repository from this template +## Lesson Description -To use this template to start a new lesson repository, -make sure you're logged into Github. +## Rendered Version of This Lesson + +Version 1.0 + +## Contact Information + +[Rbanism Community](mailto:rbanism@tudelf.nl) + +## Contributing Information + +Please see the [CONTRIBUTING page](https://github.com/carpentries-incubator/r-geospatial-urban/blob/main/CONTRIBUTING.md) for guidance on how to contribute to this lessom. + +## Credits / Acknowledgements + +- [Daniele Cannatella](https://github.com/dcannatella) +- [Clémentine Cottineau](https://github.com/ClementineCttn) +- [Claudiu Forgaci](https://github.com/cforgaci) +- [Jerome Francisco Conceicao](https://github.com/fcjerome) +- [Manuel Garcia](https://github.com/manuGil) +- [Kyri Janssen](https://github.com/KyriJanssen) +- [Selin Kubilay](https://github.com/Selkubi) +- [Ana Petrovic](https://github.com/ana-5r) +- [Aleksandra Wilczynska](https://github.com/alwil) + +## Citation + +## License + +The R Geospatial Urban lesson, like most other software provided by The Carpentries, are made available under the OSI-approved MIT license. Please see the [LICENSE page](https://github.com/carpentries-incubator/r-geospatial-urban/blob/main/LICENSE.md) for further information. + +To use this template to +start a new lesson repository, +make sure you're logged into Github. Visit https://github.com/carpentries/workbench-template-rmd/generate and follow the instructions. Checking the 'Include all branches' option will save some time waiting for the first website build @@ -13,7 +44,7 @@ when your new repository is initialised. If you have any questions, contact [@zkamvar](https://github.com/zkamvar) -## Configure a new lesson +## Rendered Version of This Lesson Follow the steps below to complete the initial configuration of a new lesson repository built from this template: @@ -36,7 +67,7 @@ complete the initial configuration of a new lesson repository built from this te - `contact` 1. **Annotate the repository** with site URL and topic tags: navigate back to the repository landing page and - click on the gear wheel/cog icon (similar to ⚙️) + click on the gear wheel/cog icon (similar to ⚙️) at the top-right of the _About_ box. Check the "Use your GitHub Pages website" option, and [add some keywords and other annotations to describe your lesson](https://cdh.carpentries.org/the-carpentries-incubator.html#topic-tags) @@ -47,24 +78,24 @@ complete the initial configuration of a new lesson repository built from this te - the human language the lesson is written in (e.g. `deutsch`) 1. **Adjust the name of the `.Rproj` file.** It is simplest to make this match the name of the repository. -1. **Adjust the +1. **Adjust the `CODE_OF_CONDUCT.md`, `CONTRIBUTING.md`, and `LICENSE.md` files** as appropriate for your project. - - `CODE_OF_CONDUCT.md`: - if you are using this template for a project outside The Carpentries, - you should adjust this file to describe - who should be contacted with Code of Conduct reports, - and how those reports will be handled. - - `CONTRIBUTING.md`: - depending on the current state and maturity of your project, - the contents of the template Contributing Guide may not be appropriate. - You should adjust the file to help guide contributors on how best - to get involved and make an impact on your lesson. - - `LICENSE.md`: - in line with the terms of the CC-BY license, - you should ensure that the copyright information - provided in the license file is accurate for your project. -1. **Update this README with + - `CODE_OF_CONDUCT.md`: + if you are using this template for a project outside The Carpentries, + you should adjust this file to describe + who should be contacted with Code of Conduct reports, + and how those reports will be handled. + - `CONTRIBUTING.md`: + depending on the current state and maturity of your project, + the contents of the template Contributing Guide may not be appropriate. + You should adjust the file to help guide contributors on how best + to get involved and make an impact on your lesson. + - `LICENSE.md`: + in line with the terms of the CC-BY license, + you should ensure that the copyright information + provided in the license file is accurate for your project. +1. **Update this README with [relevant information about your lesson](https://carpentries.github.io/lesson-development-training/collaborating-newcomers.html#readme)** and delete this section.