admin2/manual_teachbooks
1
0
Fork 0
mirror of https://github.com/TeachBooks/manual.git synced 2026-11-12 22:35:51 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

WIP

Browse source
This commit is contained in:
Tom van Woudenberg 2025-02-24 21:30:42 +01:00
parent dedfdd7d97
commit 3c97679bb7
3 changed files with 4 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

2
book/credits.md
View file

@ -60,7 +60,7 @@ The following pages contain content written by others, part of has been reused a
- Pages {ref}`copyright` and {ref}`copyright_considerations` include text from {cite:t}`tud_cip_24` that is used in the copyright checklist items. Original content licensed under CC BY.
- Page {ref}`copyright_licenses`: {numref}`Figure %s<fig_license_types>` is included unmodified, along with paraphrased and quoted text (including hyperlinks) from {cite:t}`hall21`. Work is licensed under CC BY.
- Page {ref}`copyright_licenses`: {numref}`Figure %s<fig_license_compatibility>` is included unmodified. Work is provided by Kennisland under a CC0 license. Accessed at [](https://wiki.creativecommons.org/wiki/File:CC_License_Compatibility_Chart.png) on December 17, 2024.
- page [](./installation-and-setup/versioning.md): includes text from {cite:t}`semver` that has been modified. Original content licensed under CC BY 3.0.
- page [](./installation-and-setup/versioning_changelog.md): includes text from {cite:t}`semver` that has been modified. Original content licensed under CC BY 3.0.

2
book/installation-and-setup/versioning.md
View file

@ -1,7 +1,5 @@
# Versioning and URLs
> This page reuses adapted CC BY 3.0 content from Tom Preston-Werner {cite:t}`semver`. {fa}`quote-left`{ref}`Find out more here.<external_resources>`
```{admonition} User types
:class: tip
This page is useful for user type 4-5.

3
book/installation-and-setup/versioning_changelog.md
View file

@ -1,4 +1,7 @@
# TeachBooks versioning with changelog
> This page reuses adapted CC BY 3.0 content from Tom Preston-Werner {cite:t}`semver`. {fa}`quote-left`{ref}`Find out more here.<external_resources>`
Versions combined with a changelog can be a very effective way to communicate book changes to the reader and allow reuse of specific versions. Inspired by versioning systems in software management (i.e. semantic and CalVer versioning) you can define a version guideline in which the version number tells the reader about the impact of the change. This might more suitable for your online books than the more traditional way of versioning paper books (version 1, 2, etc.), because of the amount of edits which online books allow. We recommend TeachBooks versioning, which comes in two flavors:
1. `academic_year.additions.errata` versioning for books tailed-made for courses in which content is added / adapted during the course and might be restructured extensively every year while remaining to be available in the original form.