Complete Migration from RDT to Docusaurus (#6227)

- Delete the contents of doc/read-the-docs-site, only keeping the README with a migration notice. - Move docusaurus folder into doc folder. - Update the GH workflows for publishing the haddock site and docusaurus site. - Delete GH web hook and update redirects on RTD site. - Remove mentions of read-the-docs and combined-haddock from nix code - Update release process, mentioning how to publish Docusaurus and the Haddock site - Update links in Docusaurus mentioning the new haddock site
IntersectMBO · Jun 21, 2024 · 151887d · 151887d
1 parent c33af07
commit 151887d
Show file tree

Hide file tree

Showing 162 changed files with 125 additions and 4,990 deletions.
diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -9,7 +9,7 @@ body:
  attributes:
  value: |
  Thanks for taking the time to fill out this bug report.
- Please check the existing issues, [Plutus Docs](https://plutus.readthedocs.io/en/latest/) and [Cardano Stack Exchange](https://cardano.stackexchange.com/) before raising.
+ Please check the existing issues, [Plutus Docs](https://intersectmbo.github.io/plutus/docs) and [Cardano Stack Exchange](https://cardano.stackexchange.com/) before raising.
  - type: textarea
  id: summary
  attributes:

diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -8,7 +8,7 @@ body:
  attributes:
  value: |
  Thanks for taking the time to fill out this feature request.
- Please check the existing issues and [Plutus Docs](https://plutus.readthedocs.io/en/latest/) before raising.
+ Please check the existing issues and [Plutus Docs](https://intersectmbo.github.io/plutus/docs) before raising.
  - type: textarea
  id: description
  attributes:

diff --git a/.github/workflows/combined-haddock.yml b/.github/workflows/combined-haddock.yml
diff --git a/.github/workflows/docusaurus-site.yml b/.github/workflows/docusaurus-site.yml
@@ -0,0 +1,31 @@
+# This workflow builds and publishes the Docusaurus site to:
+# https://intersectmbo.github.io/plutus/docs
+
+name: "🦕 Docusaurus Site" 
+
+on:
+ workflow_dispatch:
+
+jobs:
+ publish:
+ name: Publish 
+ runs-on: [self-hosted, plutus-shared]
+ permissions:
+ contents: write
+ environment:
+ name: github-pages
+ steps:
+ - name: Checkout
+ uses: actions/checkout@main
+
+ - name: Build Site 
+ working-directory: doc/docusaurus
+ run: nix develop --command bash -c 'yarn && yarn build'
+
+ - name: Deploy Site 
+ uses: JamesIves/[email protected]
+ with:
+ folder: doc/docusaurus/build
+ target-folder: docs
+ single-commit: true
+
diff --git a/.github/workflows/haddock-site.yml b/.github/workflows/haddock-site.yml
@@ -0,0 +1,59 @@
+# This workflow builds and publishes the Haddock site to:
+# https://intersectmbo.github.io/plutus/haddock/$version
+# And optionally to:
+# https://intersectmbo.github.io/plutus/haddock/latest
+
+name: "📜 Haddock Site"
+
+on:
+ workflow_dispatch:
+ inputs:
+ version:
+ description: |
+ The release version tag. For example if $version == "1.29.0.0" then the 
+ current contents of the branch tagged "1.29.0.0" will be deployed to: 
+ https://intersectmbo.github.io/plutus/haddock/$version
+ required: true
+ type: string
+
+ latest: 
+ description: |
+ If true, then the $version branch will also be deployed to:
+ https://intersectmbo.github.io/plutus/haddock/latest.
+ You want to leave this to true unless you are deploying old versions.
+ type: boolean
+ required: true 
+ default: true
+
+jobs:
+ publish:
+ name: Publish
+ runs-on: [self-hosted, plutus-shared]
+ permissions:
+ contents: write
+ environment:
+ name: github-pages
+ steps:
+ - name: Checkout
+ uses: actions/checkout@main
+ with:
+ ref: ${{ inputs.version }}
+
+ - name: Build Site
+ run: | 
+ nix develop --command ./scripts/combined-haddock.sh _haddock all
+
+ - name: Deploy Site
+ uses: JamesIves/[email protected]
+ with:
+ folder: _haddock
+ target-folder: haddock/${{ inputs.version }}
+ single-commit: true
+
+ - name: Deploy Site (latest)
+ if: ${{ inputs.latest == true }}
+ uses: JamesIves/[email protected]
+ with:
+ folder: _haddock
+ target-folder: haddock/latest
+ single-commit: true
diff --git a/.github/workflows/publish-docs.yml b/.github/workflows/publish-docs.yml
diff --git a/.readthedocs.yml b/.readthedocs.yml
diff --git a/CONTRIBUTING.adoc b/CONTRIBUTING.adoc
@@ -415,7 +415,7 @@ The amount of time it's worth spending doing this is probably much more than you
 
 PRs should target `master` unless there is a very good reason not to.
 The only PRs to release branches should be backport PRs which should consist only of cherry-picks of commits from master (and any fixups that are needed).
-For more details, see link:./doc/read-the-docs-site/RELEASE{outfilesuffix}[Plutus Release Process].
+For more details, see link:./RELEASE{outfilesuffix}[Plutus Release Process].
 
 ==== What changes to include, and pull request sizes
 
@@ -605,12 +605,10 @@ If your PR contains a dozen drive-by refactorings, it's unlikely to be merged as
 
 === Continuous integration
 
-We have a few sources of CI checks at the moment:
+We have two sources of CI checks at the moment:
 
 - Hydra
-- ReadTheDocs
 - Github Actions
-- Buildkite
 
 The CI will report statuses on your PRs with links to the logs in case of failure.
 Pull requests cannot be merged without at least the Hydra CI check being green.
@@ -632,16 +630,11 @@ These will be automatically retried, but if you're in a hurry Michael has permis
 Nondeterministic failures are very annoying.
 Michael also has permissions to restart failed builds.
 
-==== ReadTheDocs
+==== Docusaurus
 
-The documentation site is built on ReadTheDocs.
-It will build a preview for each PR which is linked from the PR status.
-It's useful to take a look if you're changing any of the documentation.
+The documentation site is built with Docusaurus.
 
-Enter the development shell using `nix develop`.
-If you get a segfault, run `GC_DONT_GC=1 nix develop` instead.
-
-Then you can run `serve-docs` to host a local instance at http://0.0.0.0:8002 (Haddock is at http://0.0.0.0:8002/haddock).
+Refer to the [README.md](doc/docusaurus/README.md) for more information.
 
 ==== Github Actions
 

diff --git a/README.adoc b/README.adoc
@@ -42,9 +42,11 @@ After setting it up you should just be able to depend on the `plutus` packages a
 
 === User documentation
 
-The main documentation is located https://intersectmbo.github.io/plutus/master/docs/[here].
+The main documentation is located https://intersectmbo.github.io/plutus/docs/[here].
 
-The latest documentation for the metatheory can be found https://ci.iog.io/job/input-output-hk-plutus/master/x86_64-linux.packages.plutus-metatheory-site/latest/download/1[here].
+The haddock documentation is located https://intersectmbo.github.io/plutus/haddock/[here].
+
+The documentation for the metatheory can be found https://intersectmbo.github.io/plutus/metatheory/[here].
 
 === Talks
 

diff --git a/cabal.project b/cabal.project
@@ -18,8 +18,7 @@ index-state:
  -- Bump this if you need newer packages from CHaP
  , cardano-haskell-packages 2024-01-16T11:00:00Z
 
-packages: doc/read-the-docs-site
- plutus-benchmark
+packages: plutus-benchmark
  plutus-conformance
  plutus-core
  plutus-ledger-api

diff --git a/docusaurus/.gitignore → doc/docusaurus/.gitignore b/docusaurus/.gitignore → doc/docusaurus/.gitignore
diff --git a/docusaurus/README.md → doc/docusaurus/README.md b/docusaurus/README.md → doc/docusaurus/README.md
@@ -26,16 +26,6 @@ This command generates static content into the `build` directory and can be serv
 
 ### Deployment
 
-Using SSH:
+Go to the [docusaurus-site.yml](https://github.com/IntersectMBO/plutus/actions/workflows/docusaurus-site.yml) workflow and click `Run workflow` on the right.
 
-```
-$ USE_SSH=true yarn deploy
-```
-
-Not using SSH:
-
-```
-$ GIT_USER=<Your GitHub username> yarn deploy
-```
-
-If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.
+This will build and publish the website to the `gh-pages` branch at https://intersectmbo.github.io/plutus/docs.
diff --git a/docusaurus/babel.config.js → doc/docusaurus/babel.config.js b/docusaurus/babel.config.js → doc/docusaurus/babel.config.js
diff --git a/docusaurus/docs/adr/_category_.json → doc/docusaurus/docs/adr/_category_.json b/docusaurus/docs/adr/_category_.json → doc/docusaurus/docs/adr/_category_.json
diff --git a/docusaurus/docs/adr/adr-index.md → doc/docusaurus/docs/adr/adr-index.md b/docusaurus/docs/adr/adr-index.md → doc/docusaurus/docs/adr/adr-index.md
diff --git a/docusaurus/docs/adr/adr1.md → doc/docusaurus/docs/adr/adr1.md b/docusaurus/docs/adr/adr1.md → doc/docusaurus/docs/adr/adr1.md
diff --git a/docusaurus/docs/adr/adr2.md → doc/docusaurus/docs/adr/adr2.md b/docusaurus/docs/adr/adr2.md → doc/docusaurus/docs/adr/adr2.md
diff --git a/docusaurus/docs/adr/adr3.md → doc/docusaurus/docs/adr/adr3.md b/docusaurus/docs/adr/adr3.md → doc/docusaurus/docs/adr/adr3.md
diff --git a/docusaurus/docs/adr/adr4.md → doc/docusaurus/docs/adr/adr4.md b/docusaurus/docs/adr/adr4.md → doc/docusaurus/docs/adr/adr4.md
diff --git a/...s/docs/essential-concepts/_category_.json → ...s/docs/essential-concepts/_category_.json b/...s/docs/essential-concepts/_category_.json → ...s/docs/essential-concepts/_category_.json
diff --git a/...s/essential-concepts/language-versions.md → ...s/essential-concepts/language-versions.md b/...s/essential-concepts/language-versions.md → ...s/essential-concepts/language-versions.md
diff --git a/docusaurus/docs/essential-concepts/ledger.md → ...usaurus/docs/essential-concepts/ledger.md b/docusaurus/docs/essential-concepts/ledger.md → ...usaurus/docs/essential-concepts/ledger.md
diff --git a/...s/essential-concepts/plutus-foundation.md → ...s/essential-concepts/plutus-foundation.md b/...s/essential-concepts/plutus-foundation.md → ...s/essential-concepts/plutus-foundation.md
diff --git a/...cs/essential-concepts/plutus-platform.mdx → ...cs/essential-concepts/plutus-platform.mdx b/...cs/essential-concepts/plutus-platform.mdx → ...cs/essential-concepts/plutus-platform.mdx
diff --git a/docusaurus/docs/getting-started-plutus-tx.md → ...usaurus/docs/getting-started-plutus-tx.md b/docusaurus/docs/getting-started-plutus-tx.md → ...usaurus/docs/getting-started-plutus-tx.md
@@ -28,4 +28,4 @@ Use `cardano-cli` to deploy your script.
 
 Use an off-chain framework, such as [cardano-transaction-lib](https://github.com/Plutonomicon/cardano-transaction-lib) and [lucid](https://github.com/spacebudz/lucid), to interact with your script. 
 
-All these are based on the [Cardano API](https://github.com/IntersectMBO/cardano-node/tree/master/cardano-api), a low-level API that provides the capability to do the off-chain work with a local running node.
+All these are based on the [Cardano API](https://github.com/IntersectMBO/cardano-api), a low-level API that provides the capability to do the off-chain work with a local running node.
diff --git a/docusaurus/docs/index.md → doc/docusaurus/docs/index.md b/docusaurus/docs/index.md → doc/docusaurus/docs/index.md
diff --git a/docusaurus/docs/reference/_category_.json → ...docusaurus/docs/reference/_category_.json b/docusaurus/docs/reference/_category_.json → ...docusaurus/docs/reference/_category_.json
diff --git a/...aurus/docs/reference/common-weaknesses.md → ...aurus/docs/reference/common-weaknesses.md b/...aurus/docs/reference/common-weaknesses.md → ...aurus/docs/reference/common-weaknesses.md
diff --git a/...s/docs/reference/cost-model-parameters.md → ...s/docs/reference/cost-model-parameters.md b/...s/docs/reference/cost-model-parameters.md → ...s/docs/reference/cost-model-parameters.md
diff --git a/docusaurus/docs/reference/examples.md → doc/docusaurus/docs/reference/examples.md b/docusaurus/docs/reference/examples.md → doc/docusaurus/docs/reference/examples.md
diff --git a/...aurus/docs/reference/further-resources.md → ...aurus/docs/reference/further-resources.md b/...aurus/docs/reference/further-resources.md → ...aurus/docs/reference/further-resources.md
diff --git a/docusaurus/docs/reference/glossary.md → doc/docusaurus/docs/reference/glossary.md b/docusaurus/docs/reference/glossary.md → doc/docusaurus/docs/reference/glossary.md
diff --git a/...s/docs/reference/haddock-documentation.md → ...s/docs/reference/haddock-documentation.md b/...s/docs/reference/haddock-documentation.md → ...s/docs/reference/haddock-documentation.md
diff --git a/...docs/reference/plutus-language-changes.md → ...docs/reference/plutus-language-changes.md b/...docs/reference/plutus-language-changes.md → ...docs/reference/plutus-language-changes.md
diff --git a/...s/reference/plutus-tx-compiler-options.md → ...s/reference/plutus-tx-compiler-options.md b/...s/reference/plutus-tx-compiler-options.md → ...s/reference/plutus-tx-compiler-options.md
diff --git a/...ference/script-optimization-techniques.md → ...ference/script-optimization-techniques.md b/...ference/script-optimization-techniques.md → ...ference/script-optimization-techniques.md
diff --git a/.../upgrade-vasil-plutus-script-addresses.md → .../upgrade-vasil-plutus-script-addresses.md b/.../upgrade-vasil-plutus-script-addresses.md → .../upgrade-vasil-plutus-script-addresses.md
diff --git a/...aurus/docs/simple-example/_category_.json → ...aurus/docs/simple-example/_category_.json b/...aurus/docs/simple-example/_category_.json → ...aurus/docs/simple-example/_category_.json
diff --git a/...mple-example/alternatives-to-plutus-tx.md → ...mple-example/alternatives-to-plutus-tx.md b/...mple-example/alternatives-to-plutus-tx.md → ...mple-example/alternatives-to-plutus-tx.md
diff --git a/...docs/simple-example/auction-properties.md → ...docs/simple-example/auction-properties.md b/...docs/simple-example/auction-properties.md → ...docs/simple-example/auction-properties.md
diff --git a/...saurus/docs/simple-example/eutxo-model.md → ...saurus/docs/simple-example/eutxo-model.md b/...saurus/docs/simple-example/eutxo-model.md → ...saurus/docs/simple-example/eutxo-model.md
diff --git a/...us/docs/simple-example/further-reading.md → ...us/docs/simple-example/further-reading.md b/...us/docs/simple-example/further-reading.md → ...us/docs/simple-example/further-reading.md
diff --git a/docusaurus/docs/simple-example/libraries.md → ...cusaurus/docs/simple-example/libraries.md b/docusaurus/docs/simple-example/libraries.md → ...cusaurus/docs/simple-example/libraries.md
diff --git a/docusaurus/docs/simple-example/life-cycle.md → ...usaurus/docs/simple-example/life-cycle.md b/docusaurus/docs/simple-example/life-cycle.md → ...usaurus/docs/simple-example/life-cycle.md
diff --git a/...rus/docs/simple-example/off-chain-code.md → ...rus/docs/simple-example/off-chain-code.md b/...rus/docs/simple-example/off-chain-code.md → ...rus/docs/simple-example/off-chain-code.md
@@ -8,10 +8,10 @@ Since the main purpose of this example is to introduce Plutus Tx and Plutus Core
 
 In addition to the on-chain code, one typically needs the accompanying off-chain code and services to perform tasks like building transactions, submitting transactions, deploying smart contracts, querying for available UTXOs on the chain, etc.
 
-<!-- Correct the inaccurate info below about Plutus Apps -->
+<!-- TODO Correct the inaccurate info below about Plutus Apps -->
 
 A full suite of solutions is [in development](https://plutus-apps.readthedocs.io/en/latest/plutus/explanations/plutus-tools-component-descriptions.html).
 See the [plutus-apps](https://github.com/IntersectMBO/plutus-apps) repo and its accompanying [Plutus tools SDK user guide](https://plutus-apps.readthedocs.io/en/latest/) for more details.
 
 Some other alternatives include [cardano-transaction-lib](https://github.com/Plutonomicon/cardano-transaction-lib) and [lucid](https://github.com/spacebudz/lucid). 
-All these are based on the [Cardano API](https://github.com/IntersectMBO/cardano-node/tree/master/cardano-api), a low-level API that provides the capability to do the off-chain work with a local running node.
+All these are based on the [Cardano API](https://github.com/IntersectMBO/cardano-api), a low-level API that provides the capability to do the off-chain work with a local running node.
diff --git a/...rus/docs/simple-example/plutus-tx-code.md → ...rus/docs/simple-example/plutus-tx-code.md b/...rus/docs/simple-example/plutus-tx-code.md → ...rus/docs/simple-example/plutus-tx-code.md
@@ -7,7 +7,7 @@ sidebar_position: 20
 Recall that Plutus Tx is a subset of Haskell. 
 It is the source language one uses to write Plutus validators. 
 A Plutus Tx program is compiled into Plutus Core, which is interpreted on-chain. 
-The full Plutus Tx code for the auction smart contract can be found at [AuctionValidator.hs](https://github.com/IntersectMBO/plutus/blob/master/doc/read-the-docs-site/tutorials/AuctionValidator.hs).
+The full Plutus Tx code for the auction smart contract can be found at [AuctionValidator.hs](https://github.com/IntersectMBO/plutus-tx-template/blob/main/app/AuctionValidator.hs).
 
 <!-- will need to update the link and file location for the new docs platform implementation -->
 

diff --git a/...rus/docs/simple-example/simple-example.md → ...rus/docs/simple-example/simple-example.md b/...rus/docs/simple-example/simple-example.md → ...rus/docs/simple-example/simple-example.md
diff --git a/docusaurus/docs/troubleshooting.md → doc/docusaurus/docs/troubleshooting.md b/docusaurus/docs/troubleshooting.md → doc/docusaurus/docs/troubleshooting.md
diff --git a/...urus/docs/using-plutus-tx/_category_.json → ...urus/docs/using-plutus-tx/_category_.json b/...urus/docs/using-plutus-tx/_category_.json → ...urus/docs/using-plutus-tx/_category_.json
diff --git a/...vanced-plutus-tx-concepts/_category_.json → ...vanced-plutus-tx-concepts/_category_.json b/...vanced-plutus-tx-concepts/_category_.json → ...vanced-plutus-tx-concepts/_category_.json
diff --git a/...oncepts/optimizing-scripts-with-asData.md → ...oncepts/optimizing-scripts-with-asData.md b/...oncepts/optimizing-scripts-with-asData.md → ...oncepts/optimizing-scripts-with-asData.md
diff --git a/...ncepts/triggering-a-validation-failure.md → ...ncepts/triggering-a-validation-failure.md b/...ncepts/triggering-a-validation-failure.md → ...ncepts/triggering-a-validation-failure.md
diff --git a/...cs/using-plutus-tx/compiling-plutus-tx.md → ...cs/using-plutus-tx/compiling-plutus-tx.md b/...cs/using-plutus-tx/compiling-plutus-tx.md → ...cs/using-plutus-tx/compiling-plutus-tx.md
diff --git a/...ocs/using-plutus-tx/overview-plutus-tx.md → ...ocs/using-plutus-tx/overview-plutus-tx.md b/...ocs/using-plutus-tx/overview-plutus-tx.md → ...ocs/using-plutus-tx/overview-plutus-tx.md
diff --git a/.../using-plutus-tx/producing-a-blueprint.md → .../using-plutus-tx/producing-a-blueprint.md b/.../using-plutus-tx/producing-a-blueprint.md → .../using-plutus-tx/producing-a-blueprint.md
diff --git a/...g-plutus-tx/writing-plutus-tx-programs.md → ...g-plutus-tx/writing-plutus-tx-programs.md b/...g-plutus-tx/writing-plutus-tx-programs.md → ...g-plutus-tx/writing-plutus-tx-programs.md
diff --git a/...docs/working-with-scripts/_category_.json → ...docs/working-with-scripts/_category_.json b/...docs/working-with-scripts/_category_.json → ...docs/working-with-scripts/_category_.json
diff --git a/...pts/exporting-scripts-datums-redeemers.md → ...pts/exporting-scripts-datums-redeemers.md b/...pts/exporting-scripts-datums-redeemers.md → ...pts/exporting-scripts-datums-redeemers.md
diff --git a/...ng-with-scripts/profiling-budget-usage.md → ...ng-with-scripts/profiling-budget-usage.md b/...ng-with-scripts/profiling-budget-usage.md → ...ng-with-scripts/profiling-budget-usage.md
diff --git a/...scripts/writing-basic-minting-policies.md → ...scripts/writing-basic-minting-policies.md b/...scripts/writing-basic-minting-policies.md → ...scripts/writing-basic-minting-policies.md
diff --git a/...cripts/writing-basic-validator-scripts.md → ...cripts/writing-basic-validator-scripts.md b/...cripts/writing-basic-validator-scripts.md → ...cripts/writing-basic-validator-scripts.md
diff --git a/docusaurus/docusaurus.config.ts → doc/docusaurus/docusaurus.config.ts b/docusaurus/docusaurus.config.ts → doc/docusaurus/docusaurus.config.ts
@@ -8,10 +8,10 @@ const config: Config = {
  favicon: "img/favicon.ico",
 
  // Set the production url of your site here
- url: "https://plutus.readthedocs.io",
+ url: "https://intersectmbo.github.io",
  // Set the /<baseUrl>/ pathname under which your site is served
  // For GitHub pages deployment, it is often '/<projectName>/'
- baseUrl: "/plutus/master/docs/",
+ baseUrl: "/plutus/docs/",
 
  // GitHub pages deployment config.
  // If you aren't using GitHub pages, you don't need these.

diff --git a/docusaurus/package.json → doc/docusaurus/package.json b/docusaurus/package.json → doc/docusaurus/package.json
diff --git a/docusaurus/sidebars.ts → doc/docusaurus/sidebars.ts b/docusaurus/sidebars.ts → doc/docusaurus/sidebars.ts
diff --git a/docusaurus/src/components/CsvTable.tsx → doc/docusaurus/src/components/CsvTable.tsx b/docusaurus/src/components/CsvTable.tsx → doc/docusaurus/src/components/CsvTable.tsx
diff --git a/docusaurus/src/components/LiteralInclude.tsx → ...usaurus/src/components/LiteralInclude.tsx b/docusaurus/src/components/LiteralInclude.tsx → ...usaurus/src/components/LiteralInclude.tsx
diff --git a/docusaurus/src/css/custom.css → doc/docusaurus/src/css/custom.css b/docusaurus/src/css/custom.css → doc/docusaurus/src/css/custom.css
diff --git a/docusaurus/src/theme/Footer/index.js → doc/docusaurus/src/theme/Footer/index.js b/docusaurus/src/theme/Footer/index.js → doc/docusaurus/src/theme/Footer/index.js
diff --git a/docusaurus/src/theme/MDXComponents.ts → doc/docusaurus/src/theme/MDXComponents.ts b/docusaurus/src/theme/MDXComponents.ts → doc/docusaurus/src/theme/MDXComponents.ts
diff --git a/docusaurus/static/.nojekyll → doc/docusaurus/static/.nojekyll b/docusaurus/static/.nojekyll → doc/docusaurus/static/.nojekyll
diff --git a/docusaurus/static/code/AuctionValidator.hs → ...ocusaurus/static/code/AuctionValidator.hs b/docusaurus/static/code/AuctionValidator.hs → ...ocusaurus/static/code/AuctionValidator.hs
diff --git a/...-the-docs-site/tutorials/BasicPlutusTx.hs → doc/docusaurus/static/code/BasicPlutusTx.hs b/...-the-docs-site/tutorials/BasicPlutusTx.hs → doc/docusaurus/static/code/BasicPlutusTx.hs
diff --git a/docusaurus/static/code/BasicPolicies.hs → doc/docusaurus/static/code/BasicPolicies.hs b/docusaurus/static/code/BasicPolicies.hs → doc/docusaurus/static/code/BasicPolicies.hs
diff --git a/docusaurus/static/code/BasicValidators.hs → ...docusaurus/static/code/BasicValidators.hs b/docusaurus/static/code/BasicValidators.hs → ...docusaurus/static/code/BasicValidators.hs
diff --git a/docusaurus/static/code/Cip57Blueprint.hs → doc/docusaurus/static/code/Cip57Blueprint.hs b/docusaurus/static/code/Cip57Blueprint.hs → doc/docusaurus/static/code/Cip57Blueprint.hs
diff --git a/...ead-the-docs-site/tutorials/QuickStart.hs → doc/docusaurus/static/code/QuickStart.hs b/...ead-the-docs-site/tutorials/QuickStart.hs → doc/docusaurus/static/code/QuickStart.hs
diff --git a/doc/read-the-docs-site/howtos/plutus.json → doc/docusaurus/static/code/plutus.json b/doc/read-the-docs-site/howtos/plutus.json → doc/docusaurus/static/code/plutus.json
diff --git a/.../reference/cardano/builtin-parameters.csv → ...usaurus/static/csv/builtin-parameters.csv b/.../reference/cardano/builtin-parameters.csv → ...usaurus/static/csv/builtin-parameters.csv
diff --git a/.../reference/cardano/machine-parameters.csv → ...usaurus/static/csv/machine-parameters.csv b/.../reference/cardano/machine-parameters.csv → ...usaurus/static/csv/machine-parameters.csv
diff --git a/...ocs-site/closing-tx-simple-auction-v3.png → ...atic/img/closing-tx-simple-auction-v3.png b/...ocs-site/closing-tx-simple-auction-v3.png → ...atic/img/closing-tx-simple-auction-v3.png
diff --git a/...rus/static/img/docusaurus-social-card.png → ...rus/static/img/docusaurus-social-card.png b/...rus/static/img/docusaurus-social-card.png → ...rus/static/img/docusaurus-social-card.png
diff --git a/...common-weaknesses/double-satisfaction.png → ...saurus/static/img/double-satisfaction.png b/...common-weaknesses/double-satisfaction.png → ...saurus/static/img/double-satisfaction.png
diff --git a/docusaurus/static/img/favicon.ico → doc/docusaurus/static/img/favicon.ico b/docusaurus/static/img/favicon.ico → doc/docusaurus/static/img/favicon.ico
diff --git a/...docs-site/first-bid-simple-auction-v3.png → ...tatic/img/first-bid-simple-auction-v3.png b/...docs-site/first-bid-simple-auction-v3.png → ...tatic/img/first-bid-simple-auction-v3.png
diff --git a/docusaurus/static/img/github.svg → doc/docusaurus/static/img/github.svg b/docusaurus/static/img/github.svg → doc/docusaurus/static/img/github.svg
diff --git a/docusaurus/static/img/logo-footer.svg → doc/docusaurus/static/img/logo-footer.svg b/docusaurus/static/img/logo-footer.svg → doc/docusaurus/static/img/logo-footer.svg
diff --git a/docusaurus/static/img/logo.svg → doc/docusaurus/static/img/logo.svg b/docusaurus/static/img/logo.svg → doc/docusaurus/static/img/logo.svg
diff --git a/...te/explanations/platform-architecture.png → ...urus/static/img/platform-architecture.png b/...te/explanations/platform-architecture.png → ...urus/static/img/platform-architecture.png
diff --git a/...ocs-site/second-bid-simple-auction-v3.png → ...atic/img/second-bid-simple-auction-v3.png b/...ocs-site/second-bid-simple-auction-v3.png → ...atic/img/second-bid-simple-auction-v3.png
diff --git a/docusaurus/tsconfig.json → doc/docusaurus/tsconfig.json b/docusaurus/tsconfig.json → doc/docusaurus/tsconfig.json
diff --git a/docusaurus/yarn.lock → doc/docusaurus/yarn.lock b/docusaurus/yarn.lock → doc/docusaurus/yarn.lock
diff --git a/doc/read-the-docs-site/.gitignore b/doc/read-the-docs-site/.gitignore