feat: major documentation refresh

.buildkite/deployment.sh

@@ -61,11 +61,4 @@ steps:
     agents:
       upload: "fast"
     if: build.tag != null
-
-  - label: ":book: Deploy Documentation"
-    command: "syncdoc.sh"
-    depends_on: ~
-    agents:
-      upload: "fast"
-    if: build.branch == "master"
-EOF
+EOF

.github/ISSUE_TEMPLATE/config.yml

@@ -2,7 +2,7 @@
 blank_issues_enabled: false
 contact_links:
   - name: Documentation
-    url: https://www.authelia.com/docs/
+    url: https://www.authelia.com/
     about: Read the Documentation
   - name: Matrix
     url: https://matrix.to/#/#community:authelia.com

.renovaterc

@@ -4,6 +4,9 @@
     ":semanticCommitTypeAll(build)",
     ":separatePatchReleases"
   ],
+  "ignorePaths": [
+  	"docs/**"
+  ],
   "ignorePresets": [
     ":combinePatchMinorReleases",
     "helpers:disableTypesNodeMajor",
@@ -58,4 +61,4 @@
       "gomodTidy",
       "gomodNoMassage"
   ]
-}
+}

.yamllint.yml

@@ -2,6 +2,7 @@
 extends: default
 
 ignore: |
+  docs/pnpm-lock.yaml
   internal/configuration/test_resources/config_bad_quoting.yml
   web/pnpm-lock.yaml
   web/node_modules/

CONTRIBUTING.md

@@ -1,7 +1,7 @@
 # Contributing
 
-Anybody willing to contribute to the project either with code, documentation, security reviews or whatever, are very 
-welcome to create or review pull requests and take part in discussions in any of our public 
+Anybody willing to contribute to the project either with code, documentation, security reviews or whatever, are very
+welcome to create or review pull requests and take part in discussions in any of our public
 [chat rooms](./README.md#contact-options).
 
 It's also possible to contribute financially in order to support the community.
@@ -15,11 +15,13 @@ If you've found a **bug** or have a **feature request** then please create an is
 ## Code
 
 If you would like to fix a bug or implement a feature, please fork the repository and create a Pull Request.
-More information on getting set up locally can be found [here](https://www.authelia.com/docs/contributing/).
+More information on getting set up locally can be found in the
+[Development Contribution](https://www.authelia.com/contributing/development/introduction/) documentation.
 
-Before you start any Pull Request, it's recommended that you create an issue to discuss first if you have any doubts about requirement or implementation.
-That way you can be sure that the maintainer(s) agree on what to change and how, and you can hopefully get a quick merge afterwards.
-Also, let the maintainers know that you plan to work on a particular issue so that no one else starts any duplicate work.
+Before you start any Pull Request, it's recommended that you create an issue to discuss first if you have any doubts
+about requirement or implementation. That way you can be sure that the maintainer(s) agree on what to change and how,
+and you can hopefully get a quick merge afterwards. Also, let the maintainers know that you plan to work on a particular
+issue so that no one else starts any duplicate work.
 
 Pull Requests can only be merged once all status checks are green, which means `authelia-scripts --log-level debug ci` passes, and coverage does not regress.
 
@@ -37,7 +39,7 @@ Read more about this in the [GitHub docs, Re-requesting a review](https://docs.g
 
 ## Collaboration with maintainers
 
-Sometimes the codebase can be a challenge to navigate, especially for a first-time contributor. We don't want you 
+Sometimes the codebase can be a challenge to navigate, especially for a first-time contributor. We don't want you
 spending an hour trying to work out something that would take us only a minute to explain.
 
 If you'd like some help getting started we have several [contact options](./README.md#contact-options) available.

README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="./docs/images/authelia-title.png" width="350" title="Authelia">
+  <img src="./docs/static/images/authelia-title.png" width="350" title="Authelia">
 </p>
 
   [![Build](https://img.shields.io/buildkite/d6543d3ece3433f46dbe5fd9fcfaf1f68a6dbc48eb1048bc22/master?logo=buildkite&style=flat-square&color=brightgreen)](https://buildkite.com/authelia/authelia)
@@ -20,12 +20,12 @@ sign-on (SSO) for your applications via a web portal. It acts as a companion for
 [Traefik], [caddy] or [HAProxy] to let them know whether requests should either be allowed or redirected to Authelia's
 portal for authentication.
 
-Documentation is available at https://www.authelia.com/docs.
+Documentation is available at [https://www.authelia.com/](https://www.authelia.com/).
 
 The following is a simple diagram of the architecture:
 
 <p align="center" style="margin:50px">
-  <img src="./docs/images/archi.png"/>
+  <img src="./docs/static/images/archi.png"/>
 </p>
 
 **Authelia** can be installed as a standalone service from the [AUR](https://aur.archlinux.org/packages/authelia/),
@@ -36,27 +36,27 @@ The following is a simple diagram of the architecture:
 the Helm [Chart](https://charts.authelia.com) (beta) leveraging ingress controllers and ingress configurations.
 
 <p align="center">
-  <img src="./docs/images/logos/kubernetes.png" height="100"/>
-  <img src="./docs/images/logos/docker.logo.png" width="100">
+  <img src="./docs/static/images/logos/kubernetes.png" height="100"/>
+  <img src="./docs/static/images/logos/docker.logo.png" width="100">
 </p>
 
 Here is what Authelia's portal looks like:
 
 <p align="center">
-  <img src="./docs/images/1FA.png" width="400" />
-  <img src="./docs/images/2FA-METHODS.png" width="400" />
+  <img src="./docs/static/images/1FA.png" width="400" />
+  <img src="./docs/static/images/2FA-METHODS.png" width="400" />
 </p>
 
 ## Features summary
 
 This is a list of the key features of Authelia:
 
 * Several second factor methods:
-  * **[Security Keys](https://www.authelia.com/docs/features/2fa/security-key)** that support [FIDO2]&nbsp;[Webauthn]
-    with devices like a [YubiKey].
-  * **[Time-based One-Time password](https://www.authelia.com/docs/features/2fa/one-time-password)**
+  * **[Security Keys](https://www.authelia.com/overview/authentication/webauthn-security-key/)** that support
+    [FIDO2]&nbsp;[Webauthn] with devices like a [YubiKey].
+  * **[Time-based One-Time password](https://www.authelia.com/overview/authentication/one-time-password/)**
     with compatible authenticator applications.
-  * **[Mobile Push Notifications](https://www.authelia.com/docs/features/2fa/push-notifications)**
+  * **[Mobile Push Notifications](https://www.authelia.com/overview/authentication/push-notification/)**
     with [Duo](https://duo.com/).
 * Password reset with identity verification using email confirmation.
 * Access restriction after too many invalid authentication attempts.
@@ -78,45 +78,48 @@ This is a list of the key features of Authelia:
     [Traefik Kubernetes Ingress](https://doc.traefik.io/traefik/providers/kubernetes-crd/) Kubernetes ingress
     controllers out of the box.
   * Beta support for installing via Helm using our [Charts](https://charts.authelia.com).
-* Beta support for [OpenID Connect](https://www.authelia.com/docs/configuration/identity-providers/oidc.html).
+* Beta support for [OpenID Connect](https://www.authelia.com/roadmap/active/openid-connect/).
 
-For more details about the features, follow [Features](https://www.authelia.com/docs/features/).
+For more details take a look at the [Overview](https://www.authelia.com/overview/prologue/introduction/).
 
-If you want to know more about the roadmap, follow [Roadmap](https://www.authelia.com/docs/roadmap).
+If you want to know more about the roadmap, follow [Roadmap](https://www.authelia.com/roadmap).
 
 ## Proxy support
 
 Authelia works in combination with [nginx], [Traefik], [caddy] or [HAProxy]. It can be deployed on bare metal with
 Docker or on top of [Kubernetes].
 
 <p align="center">
-  <img src="./docs/images/logos/nginx.png" height="50"/>
-  <img src="./docs/images/logos/traefik.png" height="50"/>
-  <img src="./docs/images/logos/caddy.png" height="50"/>
-  <img src="./docs/images/logos/haproxy.png" height="50"/>
-  <img src="./docs/images/logos/kubernetes.png" height="50"/>
+  <img src="./docs/static/images/logos/nginx.png" height="50"/>
+  <img src="./docs/static/images/logos/traefik.png" height="50"/>
+  <img src="./docs/static/images/logos/caddy.png" height="50"/>
+  <img src="./docs/static/images/logos/haproxy.png" height="50"/>
+  <img src="./docs/static/images/logos/kubernetes.png" height="50"/>
 </p>
 
 ***Help Wanted:*** Assistance would be appreciated in getting Authelia working with
 [Envoy](https://www.envoyproxy.io/).
 
 <p align="center">
-  <img src="./docs/images/logos/envoy.png" height="50"/>
+  <img src="./docs/static/images/logos/envoy.png" height="50"/>
 </p>
 
 ## Getting Started
 
+See the [Get Started Guide](https://www.authelia.com/integration/prologue/get-started/) or one of the curated examples
+below.
+
 ### docker-compose
 
 The `docker-compose` bundles act as a starting point for anyone wanting to see Authelia in action. You will have to
 customize them to your needs as they come with self-signed certificates.
 
-#### [Local](https://www.authelia.com/docs/getting-started)
+#### [Local](https://www.authelia.com/integration/deployment/docker/#local)
 The Local compose bundle is intended to test Authelia without worrying about configuration.
 It's meant to be used for scenarios where the server is not be exposed to the internet.
 Domains will be defined in the local hosts file and self-signed certificates will be utilised.
 
-#### [Lite](https://www.authelia.com/docs/deployment/deployment-lite)
+#### [Lite](https://www.authelia.com/integration/deployment/docker/#lite)
 The Lite compose bundle is intended for scenarios where the server will be exposed to the internet, domains and DNS will
 need to be setup accordingly and certificates will be generated through LetsEncrypt. The Lite element refers to minimal
 external dependencies; File based user storage, SQLite based configuration storage. In this configuration, the service
@@ -140,8 +143,8 @@ This guide will show you how to deploy it on bare metal as well as on
 Authelia takes security very seriously. If you discover a vulnerability in Authelia, please see our
 [Security Policy](https://github.com/authelia/authelia/security/policy).
 
-For more information about [security](https://www.authelia.com/docs/security/) related matters, please read
-[the documentation](https://www.authelia.com/docs/security/).
+For more information about [security](https://www.authelia.com/information/security/) related matters, please read
+[the documentation](https://www.authelia.com/information/security/).
 
 ## Contact Options
 
@@ -345,22 +348,17 @@ Companies contributing to Authelia will have a specical mention below. [[Become
 
 #### Balto
 
-Thank you to [<img src="./docs/images/logos/balto.svg" alt="Balto" width="32"> Balto](https://www.getbalto.com/) for
-hosting our apt repository.
-
-#### Digital Ocean
-
-Thank you to [<img src="./docs/images/logos/digitalocean.svg" alt="Digital Ocean" width="32"> DigitalOcean](https://www.digitalocean.com/?from=Authelia) for
-contributing on OpenCollective.
+Thank you to [<img src="./docs/static/images/logos/balto.svg" alt="Balto" width="32"> Balto](https://www.getbalto.com/)
+for hosting our apt repository.
 
 #### JetBrains
 
-Thank you to [<img src="./docs/images/logos/jetbrains.svg" alt="JetBrains" width="32"> JetBrains](https://www.jetbrains.com/?from=Authelia)
+Thank you to [<img src="./docs/static/images/logos/jetbrains.svg" alt="JetBrains" width="32"> JetBrains](https://www.jetbrains.com/?from=Authelia)
 for providing us with free licenses to their great tools.
 
-* [<img src="./docs/images/logos/intellij-idea.svg" alt="IDEA" width="32"> IDEA](http://www.jetbrains.com/idea/)
-* [<img src="./docs/images/logos/goland.svg" alt="GoLand" width="32"> GoLand](http://www.jetbrains.com/go/)
-* [<img src="./docs/images/logos/webstorm.svg" alt="WebStorm" width="32"> WebStorm](http://www.jetbrains.com/webstorm/)
+* [<img src="./docs/static/images/logos/intellij-idea.svg" alt="IDEA" width="32"> IDEA](http://www.jetbrains.com/idea/)
+* [<img src="./docs/static/images/logos/goland.svg" alt="GoLand" width="32"> GoLand](http://www.jetbrains.com/go/)
+* [<img src="./docs/static/images/logos/webstorm.svg" alt="WebStorm" width="32"> WebStorm](http://www.jetbrains.com/webstorm/)
 
 ## License
 

SECURITY.md

@@ -2,20 +2,20 @@
 
 ## Prologue
 
-Authelia takes security very seriously. We follow the rule of 
+Authelia takes security very seriously. We follow the rule of
 [responsible disclosure](https://en.wikipedia.org/wiki/Responsible_disclosure), and we urge our community to do so as
 well instead of making the vulnerability public. This allows time for the security issue to be patched quickly.
 
-If you discover a vulnerability in Authelia, please first contact one of the maintainers privately  as described in the 
-[contact options](#contact-options) below. 
+If you discover a vulnerability in Authelia, please first contact one of the maintainers privately  as described in the
+[contact options](#contact-options) below.
 
 We urge you not to disclose the bug publicly at least until we've had a
-reasonable chance to fix it, and to clearly communicate any public disclosure timeline in your initial contact with us. 
+reasonable chance to fix it, and to clearly communicate any public disclosure timeline in your initial contact with us.
 If you do not have a particular public disclosure timeline, we will clearly communicate ours as we publish security
-advisories. 
+advisories.
 
-For more information about [security](https://www.authelia.com/docs/security/) related matters, please read 
-[the documentation](https://www.authelia.com/docs/security/).
+For more information about [security](https://www.authelia.com/information/security/) related matters, please read
+[the documentation](https://www.authelia.com/information/security/).
 
 ## Contact Options
 
@@ -25,7 +25,7 @@ privately which is described in each available contact method. The methods inclu
 
 ## Credit
 
-Users who report bugs will optionally be creditted for the discovery. Both in the [security advisory] and in our 
+Users who report bugs will optionally be credited for the discovery. Both in the [security advisory] and in our
 [all contributors](./README.md#contribute) configuration/documentation.
 
 ## Process
@@ -40,8 +40,8 @@ Users who report bugs will optionally be creditted for the discovery. Both in th
 
 ## Help Wanted
 
-We are actively looking for sponsorship to obtain either a code security audit, penetration testing, or other audits 
+We are actively looking for sponsorship to obtain either a code security audit, penetration testing, or other audits
 related to improving the security of Authelia. If your company or you personally are willing to offer discounts, pro
 bono, or funding towards services like these please feel free to contact us on *any* of the methods above.
 
-[security advisory]: https://github.com/authelia/authelia/security/advisories
+[security advisory]: https://github.com/authelia/authelia/security/advisories