diff --git a/index.qmd b/index.qmd index e1ca74c..7fd079f 100644 --- a/index.qmd +++ b/index.qmd @@ -1,3 +1,46 @@ # Welcome! {{< include includes/_wip.qmd >}} + +BACKGROUND: CHALLENGE + +BACKGROUND: NEED + +This course is designed to address these issues. We use a variety of +learning activities like code-along sessions (instructor and learner +coding together), reading activities, discussions, a few presentations, +hands-on exercises, as well as a final group project. This website +contains all of the material for the course, from reading material to +exercises to images. It is structured as a book, with "chapters" as +lessons, given in order of appearance. We make heavy use of the website +throughout the course where code-along sessions follow the material on +the website nearly exactly (with slight modifications for time or more +detailed explanations). + +The course material was created using [Quarto](https://quarto.org/) to +write the lessons and create the book format, +[GitHub](https://github.com/) to host the [Git](https://git-scm.com/) +repository of the material, and [GitHub +Actions](https://github.com/features/actions) with +[Netlify](https://www.netlify.com/) to create and host the website. The +original source material for this course is found on the +[`cog-flow-intro`](https://github.com/rostools/cog-flow-intro) GitHub +repository. + +Want to contribute to this course? Check out the +[README](https://github.com/rostools/cog-flow-intro/blob/main/README.md) +file as well as the +[CONTRIBUTING](https://github.com/rostools/cog-flow-intro/blob/main/CONTRIBUTING.md) +file on the GitHub repository for more details. The main way to +contribute is by using [GitHub](https://github.com/) and creating a [new +Issue](https://github.com/rostools/cog-flow-intro/issues/new) to make +comments and give feedback for the material. + +## Re-use and licensing {#licensing} + +Creative Commons License + +The course is licensed under the [Creative Commons Attribution 4.0 +International License](https://creativecommons.org/licenses/by/4.0/) so +the material can be used, re-used, and modified, as long as there is +attribution to this source.