update readme

Author: wirednkod

.github/workflows/pages.yml

@@ -46,8 +46,8 @@ jobs:
         run: mdbook build
       - name: Embed `html-slides` into `html-book`, fix relative paths
         run: |
-          rsync -av html-slides/content/ html-book/ --ignore-existing
-          rsync -av html-slides/ --exclude 'content' html-book/ --ignore-existing
+          rsync -av html-slides/content/ html-book/
+          rsync -av html-slides/ --exclude 'content' html-book/
           find html-book/ -regex .*\.html | xargs sed -i'' -e 's#./../../../#../../#g' > /dev/null
 
       # TODO: Without making a _branch_ that bloats the .git object,

content/README.md

@@ -1,13 +1,34 @@
-# Syllabus
-
-| Module | Name                                                                                                         |
-| ------ | ------------------------------------------------------------------------------------------------------------ |
-| 1      | [Cryptography for Blockchain](./1-Cryptography/index.md)                                                     |
-| 2      | [Interdisciplinary Concepts for Decentralized Devs (Econ, Polisci)](./2-Economics/index.md)                  |
-| 3      | [Blockchain](./3-Blockchain/index.md)                                                                        |
-| 4      | [Core and Basics](./4-Core_and_Basics/index.md)                                                              |
-| 5      | [PVM, Polkadot Architecture and Smart Contracts](./5-PVM-Polkadot-Architecture-and-Smart-Contracts/index.md) |
-| 6      | [Protocol track (Polkadot Cloud)](./6-Protocol_On-Chain/index.md)                                            |
-| 7      | [dApps track (Polkadot Hub)](./7-dApps_Off-Chain/index.md)                                                   |
-| 8      | [Governance](./8-Governance/index.md)                                                                        |
-| 9      | [Polkadot, JAM and the future](./9-Polkadot/index.md)                                                        |
+# Course Materials Book
+
+This book is the home of the majority of materials used within the dApps and Protocol Tracks of the [Polkadot Blockchain Academy](https://polkadot.academy).
+
+## Read the Book
+
+We suggest the [online](#hosted-online) version for general use, but cloning, installing, and building this book [offline](#build-offline) is a great option on-the-go.
+
+### Hosted Online
+
+The latest version is hosted at: <a target="_blank" href="https://polkadot-blockchain-academy.github.io/pba-book/">https://polkadot-blockchain-academy.github.io/pba-book/</a>
+
+### Build Offline
+
+The Protocol Track of the Academy is Rust _heavy_ and as such, you need to [install rust](https://www.rust-lang.org/tools/install) before you can continue.
+
+In order to `make` your life easy 😉, there is a set of tasks that use [`cargo make`](https://sagiegurari.github.io/cargo-make/#overview).
+
+With [`cargo make`](https://sagiegurari.github.io/cargo-make/#installation) installed, you can list all tasks included to facilitate further installation, building, serving, formatting, and more with:
+
+```sh
+# Run from the top-level working dir of this repo
+makers --list-all-steps
+```
+
+The tasks should be self-explanatory, if they are not - please file an issue to help us make them better.
+
+## License and Use Policies
+
+All materials found within this repository are licensed under Mozilla Public License Version 2.0 - See the [License](./LICENSE.md) for details.
+
+In addition to the license, we ask you read and respect the Academy's [Code of Conduct](./CODE-OF-CONDUCT.md) and help us foster a healthy and scholarly community of high academic integrity.
+
+<h3 align="center"><a href="https://dot.li/pba-github">Learn more about and apply for the next Academy today!</a></h3>