src/README.md

   1 <!--
   2 SPDX-FileCopyrightText: 2023 Xavier Bordoy
   3
   4 SPDX-License-Identifier: CC-BY-NC-SA-4.0
   5 -->
   6
   7 # Introduction
   8
   9 The project `teaching-cabinet.cc` is my personal project. Its aim is to collect what I think it's useful to teach: activities, ideas, notes, reflections, etc. Probably, it has a bias to include mathematical stuff.
  10
  11 As a personal project, I made it on my spare time. Thus I will create new contents or review old ones when I could, with no pre-established pace.
  12
  13 ## Autorship
  14
  15 The collection is made by myself, [Xavier Bordoy](https://mathstodon.xyz/@somenxavier). However, the collection might include materials from diverse sources: that is, those materials might be mine or from other people:
  16 - Always I try to make proper attribution: write explicitly the authors and the license of their work.
  17 - I will only choose free or at least permissive licenses (Creative Commons or Public Domain are examples of those).
  18
  19 Anyway, unless otherwise noted, everything here is licensed for reuse under [CC-BY-NC-SA 4.0 International](https://creativecommons.org/licenses/by-nc-sa/4.0/deed.en).
  20
  21 ## Resources
  22
  23 You have the source code in [git repository](https://repo.or.cz/teaching-cabinet.git). This project has no mailing list or bug triage system. If you want to send any suggestion, comment, bug or whatever, [email me](mailto:somenxavier@posteo.net).
  24
  25 ## Contribute
  26
  27 If you want to contribute to this project, you can:
  28
  29 - spread it
  30 - review the contents
  31 - creating new contents
  32
  33 By now, donations are not allowed, at least, until the project has more mature content.
  34
  35 ## Tools I use
  36
  37 I use [mdbook](https://rust-lang.github.io/mdBook/index.html) with the extensions: [mdbook-indexing](https://github.com/daviddrysdale/mdbook-indexing) and [mdbook-linkcheck](https://github.com/Michael-F-Bryan/mdbook-linkcheck).
  38
  39 The project is handle in [repo.or.cz](https://repo.or.cz/teaching-cabinet.git) (previously in sourcehut).
  40
  41 Images are hosted in [mathstodon posts](https://mathstodon.xyz/@somenxavier), videos on [peertube instance tubedu](https://tubedu.org/c/candoc_videos/videos) and html output in [Moritz Poldrack](https://moritz.sh/)'s server who offered gracefully after [some troubles with sourcehut pages](https://lists.sr.ht/~sircmpwn/sr.ht-discuss/%3C20231103225131.cd9376947ec87e6ebc9f709a%40posteo.net%3E).
  42
  43 verification: <a rel="me" href="https://mathstodon.xyz/@somenxavier">Mastodon</a>