@@ -185,3 +185,26 @@ To run a `.sh` in Windows, make sure you have Git installed. If Windows still do
### Thebe Lite
Thebe Lite is used to allow interactive code within the notebook. For more information on its use, read the `Live Code` page in the `Cookbook` section. For technical information, read the [Thebe Lite readme](thebe_lite/THEBE_LITE.md).
## Publishing the MUDE Websites
We have 2 websites, the "website" and the "book"
Each website has a "published" and "draft" version: the first is the official version and builds when a merge into the publish branch happens. The second is our draft book and will automatically build when you merge into main. This is where we will stage, review contents prior to sharing with students (also testing interactive functionality). I advise you to just bookmark them in a way that clarifies the difference between “draft” and “published” versions
Thus, there are 4 websites:
* Published website: [https://mude.citg.tudelft.nl/](https://mude.citg.tudelft.nl/)
A new feature is added: anything in `_toc.yml` between `# START REMOVE-FROM-PUBLISH` and `# END REMOVE-FROM-PUBLISH` will be automatically removed from the published version of the book (the banner warning about a draft book is also automatically removed).
If you need to remove the published version, a push to branch `purge-book` will deploy the book in that branch. It is set up with all unnecessary files removed and a 1-page Jupyter Book. The branch is protected with permission granted only to those with maintainer role.
I got rid of the README that used to be here, because you should have your workflow set by now, and you should know by now that you can always check it on GitLab [here](https://gitlab.tudelft.nl/mude/book/). **I'll put recent updates here for the 2 weeks leading up to the start of Q1**:
- Draft of Programming Part is ready---the first content for the "new" book to be placed! Note that it is located in `book/book/programming`.
- As you finalize the ToC for your material, move it to the same level directory as the programming part. All Parts should be a sub-directory of `book`.
- By the start of Q1, all material in `cookbook`, `old`, `sandbox` should be removed, moved or hidden (preferably by YOU!)
- **Aug 24**: draft ToC prepared for afternoon collaboration session.
````
Table of Contents notes (can turn into text on this page later):
- Modeling is a clear topic and has it's own part. Q2 topics are separated though, at least for this year
- Modeling can be both the model (and it's underlying mathematics) as well as conceptual processes. Both are very applicatble to
- Data is difficult to separate from modeling, probability and statistics topics, so it doesn't have it's own heading
- Uncertainty is far too broad a topic, so we instead rely on sub-topics like probability, statistics, observation theory, error propagation, etc
- "Uncertainty and Data" are especially difficult to extract from each other
- Modeling and Probability parts cover weeks 1.1, 1.2, 1.5, 1.6, 1.7, 1.8 (partial)
- 2.1: FVM
- 2.2: FEM
- 2.3
- 2.7-2.8: Risk & Reliability (also may be used partially in 1.7-1.8)
````{admonition} Dicatorial Proclamation by the MUDE Manager
:class: warning
The MUDE content formerly known as **coding** shall henceforth be called **programming.**
Don't like it? Too bad, maybe you can become manager next year and change it back. I have plenty of reasons, but rather than type them I believe they are better discussed over a cold beverage.
````
<!-- ```{note}
Right now, the home page of the book simply displays `README.md` which is located at `./book/` or you can [read on GitLab here](https://gitlab.tudelft.nl/mude/book/-/blob/main/README.md).
