Update README to reflect the status of govuk-aws.

README.md

@@ -1,25 +1,28 @@
-# GOV.UK AWS
+# 🚧 [Deprecated] 🚧
 
-This is the code that deploys GOV.UK in AWS.
+Please use [govuk-infrastructure] for anything new. Talk with
+#govuk-platform-engineering if you're unsure.
 
-## Getting started
+# GOV.UK AWS
 
-Start by reading [the getting started guide](docs/guides/getting-started.md).
+This is the Terraform code that still manages some of GOV.UK's AWS resources.
 
-## Building a new environment
+Platform Engineering team is in the process of:
 
-Please see [the environment provisioning guide](docs/guides/environment-provisioning.md) for building a fresh environment.
+- cleaning up disused modules
+- updating what's left and incorporating it into govuk-infrastructure
 
-## govuk-tools account
+## Getting started
 
-The `govuk-tools` account does not behave like a normal environment. It contains one-off resources and does not need to be built like a normal environment.
+Start by reading [the getting started guide](docs/guides/getting-started.md).
 
 ## Architecture Decision Records
 
-We're recording architecture decisions we make so we have a history and context on our implementation.
-
-Please see the [ADR documentation](docs/architecture/README.md) for further details.
+Some of the design choices in the history of this codebase are documented in [docs/architecture/](docs/architecture/) for posterity.
 
 ## Licence
 
 [MIT License](LICENCE)
+
+[Deprecated]: https://goomics.net/50/
+[govuk-infrastructure]: https://github.com/alphagov/govuk-infrastructure