diff --git a/website/docs/assets/images/all-dead.jpg b/docs/usage/assets/images/all-dead.jpg
similarity index 100%
rename from website/docs/assets/images/all-dead.jpg
rename to docs/usage/assets/images/all-dead.jpg
diff --git a/website/docs/assets/images/broken-lockfile.jpg b/docs/usage/assets/images/broken-lockfile.jpg
similarity index 100%
rename from website/docs/assets/images/broken-lockfile.jpg
rename to docs/usage/assets/images/broken-lockfile.jpg
diff --git a/website/docs/assets/images/dashboard-install.png b/docs/usage/assets/images/dashboard-install.png
similarity index 100%
rename from website/docs/assets/images/dashboard-install.png
rename to docs/usage/assets/images/dashboard-install.png
diff --git a/website/docs/assets/images/dashboard-login.png b/docs/usage/assets/images/dashboard-login.png
similarity index 100%
rename from website/docs/assets/images/dashboard-login.png
rename to docs/usage/assets/images/dashboard-login.png
diff --git a/website/docs/assets/images/dashboard-settings.png b/docs/usage/assets/images/dashboard-settings.png
similarity index 100%
rename from website/docs/assets/images/dashboard-settings.png
rename to docs/usage/assets/images/dashboard-settings.png
diff --git a/website/docs/assets/images/github-app-choose-repos.png b/docs/usage/assets/images/github-app-choose-repos.png
similarity index 100%
rename from website/docs/assets/images/github-app-choose-repos.png
rename to docs/usage/assets/images/github-app-choose-repos.png
diff --git a/website/docs/assets/images/github-app-install.png b/docs/usage/assets/images/github-app-install.png
similarity index 100%
rename from website/docs/assets/images/github-app-install.png
rename to docs/usage/assets/images/github-app-install.png
diff --git a/website/docs/assets/images/logo.png b/docs/usage/assets/images/logo.png
similarity index 100%
rename from website/docs/assets/images/logo.png
rename to docs/usage/assets/images/logo.png
diff --git a/website/docs/assets/images/onboarding.png b/docs/usage/assets/images/onboarding.png
similarity index 100%
rename from website/docs/assets/images/onboarding.png
rename to docs/usage/assets/images/onboarding.png
diff --git a/website/docs/bazel.md b/docs/usage/bazel.md
similarity index 100%
rename from website/docs/bazel.md
rename to docs/usage/bazel.md
diff --git a/website/docs/config-presets.md b/docs/usage/config-presets.md
similarity index 100%
rename from website/docs/config-presets.md
rename to docs/usage/config-presets.md
diff --git a/website/docs/configuration-options.md b/docs/usage/configuration-options.md
similarity index 100%
rename from website/docs/configuration-options.md
rename to docs/usage/configuration-options.md
diff --git a/website/docs/configuration-templates.md b/docs/usage/configuration-templates.md
similarity index 100%
rename from website/docs/configuration-templates.md
rename to docs/usage/configuration-templates.md
diff --git a/website/docs/configure-renovate.md b/docs/usage/configure-renovate.md
similarity index 100%
rename from website/docs/configure-renovate.md
rename to docs/usage/configure-renovate.md
diff --git a/website/docs/data-security.md b/docs/usage/data-security.md
similarity index 100%
rename from website/docs/data-security.md
rename to docs/usage/data-security.md
diff --git a/website/docs/dependency-pinning.md b/docs/usage/dependency-pinning.md
similarity index 100%
rename from website/docs/dependency-pinning.md
rename to docs/usage/dependency-pinning.md
diff --git a/website/docs/docker.md b/docs/usage/docker.md
similarity index 100%
rename from website/docs/docker.md
rename to docs/usage/docker.md
diff --git a/website/docs/faq.md b/docs/usage/faq.md
similarity index 100%
rename from website/docs/faq.md
rename to docs/usage/faq.md
diff --git a/website/docs/golang.md b/docs/usage/golang.md
similarity index 100%
rename from website/docs/golang.md
rename to docs/usage/golang.md
diff --git a/website/docs/install-github-app.md b/docs/usage/install-github-app.md
similarity index 100%
rename from website/docs/install-github-app.md
rename to docs/usage/install-github-app.md
diff --git a/website/docs/install-gitlab-app.md b/docs/usage/install-gitlab-app.md
similarity index 100%
rename from website/docs/install-gitlab-app.md
rename to docs/usage/install-gitlab-app.md
diff --git a/website/docs/java.md b/docs/usage/java.md
similarity index 100%
rename from website/docs/java.md
rename to docs/usage/java.md
diff --git a/website/docs/javascript.md b/docs/usage/javascript.md
similarity index 100%
rename from website/docs/javascript.md
rename to docs/usage/javascript.md
diff --git a/website/docs/node.md b/docs/usage/node.md
similarity index 100%
rename from website/docs/node.md
rename to docs/usage/node.md
diff --git a/website/docs/noise-reduction.md b/docs/usage/noise-reduction.md
similarity index 100%
rename from website/docs/noise-reduction.md
rename to docs/usage/noise-reduction.md
diff --git a/website/docs/nuget.md b/docs/usage/nuget.md
similarity index 100%
rename from website/docs/nuget.md
rename to docs/usage/nuget.md
diff --git a/website/docs/php.md b/docs/usage/php.md
similarity index 100%
rename from website/docs/php.md
rename to docs/usage/php.md
diff --git a/website/docs/private-modules.md b/docs/usage/private-modules.md
similarity index 100%
rename from website/docs/private-modules.md
rename to docs/usage/private-modules.md
diff --git a/website/docs/python.md b/docs/usage/python.md
similarity index 100%
rename from website/docs/python.md
rename to docs/usage/python.md
diff --git a/website/docs/reconfigure-renovate.md b/docs/usage/reconfigure-renovate.md
similarity index 100%
rename from website/docs/reconfigure-renovate.md
rename to docs/usage/reconfigure-renovate.md
diff --git a/website/docs/ruby.md b/docs/usage/ruby.md
similarity index 100%
rename from website/docs/ruby.md
rename to docs/usage/ruby.md
diff --git a/website/docs/self-hosted-configuration.md b/docs/usage/self-hosted-configuration.md
similarity index 100%
rename from website/docs/self-hosted-configuration.md
rename to docs/usage/self-hosted-configuration.md
diff --git a/website/docs/semantic-commits.md b/docs/usage/semantic-commits.md
similarity index 100%
rename from website/docs/semantic-commits.md
rename to docs/usage/semantic-commits.md
diff --git a/website/docs/updating-rebasing.md b/docs/usage/updating-rebasing.md
similarity index 100%
rename from website/docs/updating-rebasing.md
rename to docs/usage/updating-rebasing.md
diff --git a/test/website-docs.spec.js b/test/website-docs.spec.js
index f484442d4f125a396e99b9c649749c887875f492..e5c0289fd0b60ad097905eed66143826ac051cc8 100644
--- a/test/website-docs.spec.js
+++ b/test/website-docs.spec.js
@@ -2,9 +2,9 @@ const fs = require('fs');
 const options = require('../lib/config/definitions').getOptions();
 
 describe('docs', () => {
-  const doc = fs.readFileSync('website/docs/configuration-options.md', 'utf8');
+  const doc = fs.readFileSync('docs/usage/configuration-options.md', 'utf8');
   const selfHostDoc = fs.readFileSync(
-    'website/docs/self-hosted-configuration.md',
+    'docs/usage/self-hosted-configuration.md',
     'utf8'
   );
   const headers = doc