Restructure navigation

documentation/developer/index.md

@@ -0,0 +1,15 @@
+---
+id: developer_documentation
+title: Developer documentation
+description: 'Everything HACS for publishers.'
+sidebar_position: 0
+---
+
+Hi there :wave:
+
+This is the beginning of the developer documentation.
+
+Use the sidebar to navigate this section.
+
+- [If you are looking for how to use HACS have a look at the user documentation](/docs/user)
+- [If you are looking for how to publish something that can be tracked by HACS have a look at the publisher documentation](/docs/publisher)

documentation/developer/start.md

@@ -1,8 +1,7 @@
 ---
 id: start
 title: Getting started
-description: "Getting started with HACS development"
-sidebar_position: 0
+description: 'Getting started with HACS development'
 ---
 
 This integration is **massive** and there are a lot of areas to contribute to.

documentation/faq/index.mdx

@@ -0,0 +1,13 @@
+---
+id: faq_entry
+title: Frequently Asked Questions
+description: "Everything might not be frequently asked, but it's a good dumping ground for various information."
+sidebar_position: 0
+---
+
+import DocCardList from '@theme/DocCardList'
+import { useCurrentSidebarCategory } from '@docusaurus/theme-common'
+
+<i>{frontMatter.description}</i>
+
+<DocCardList items={useCurrentSidebarCategory().items} />

documentation/publisher/index.md

@@ -0,0 +1,15 @@
+---
+id: publisher_documentation
+title: Publisher documentation
+description: 'Everything HACS for publishers.'
+sidebar_position: 0
+---
+
+Hi there :wave:
+
+This is the beginning of the publisher documentation.
+
+Use the sidebar to navigate this section.
+
+- [If you are looking for how to use HACS have a look at the user documentation](/docs/user)
+- [If you are looking for how to develop/change something for HACS itself have a look at the developer documentation](/docs/developer)

documentation/setup/prerequisites.md

@@ -1,7 +1,8 @@
 ---
 id: prerequisites
 title: Prerequisites
-description: "Prerequisites"
+description: 'Prerequisites'
+sidebar_position: 0
 ---
 
 ## Requirements

documentation/user/index.md

@@ -0,0 +1,15 @@
+---
+id: user_documentation
+title: User documentation
+description: 'Everything HACS for users.'
+sidebar_position: 0
+---
+
+Hi there :wave:
+
+This is the beginning of the user documentation.
+
+Use the sidebar to navigate this section.
+
+- [If you are looking for how to publish something that can be tracked by HACS have a look at the publisher documentation](/docs/publisher)
+- [If you are looking for how to develop/change something for HACS itself have a look at the developer documentation](/docs/developer)

docusaurus.config.js

@@ -27,13 +27,11 @@ module.exports = {
  navbar: {
  title: 'HACS',
  items: [
- { to: 'docs/setup/prerequisites', label: 'Download', position: 'left' },
- { to: 'docs/configuration/basic', label: 'Configuration', position: 'left' },
- { to: 'docs/basic/getting_started', label: 'Usage', position: 'left' },
- { to: 'docs/community_guides', label: 'Guides', position: 'left' },
- { to: 'docs/developer/start', label: 'Developer docs', position: 'right' },
- { to: 'docs/faq/', label: 'FAQ', position: 'right' },
- { to: 'help', label: 'Help', position: 'right' },
+ { to: 'docs/user', label: 'Use', position: 'left' },
+ { to: 'docs/publisher', label: 'Publish', position: 'left' },
+ { to: 'docs/faq/', label: 'FAQ', position: 'left' },
+ { to: 'help', label: 'Help', position: 'left' },
+ { to: 'docs/developer', label: 'Develop', position: 'right' },
  ],
  },
  footer: {
@@ -98,7 +96,7 @@ module.exports = {
  {
  redirects: [
  {
- from: ["/default_repositories"],
+ from: ["/default_repositories",],
  to: "/"
  },
  {

sidebars.js

@@ -1,56 +1,87 @@
 module.exports = {
- usage: {
- Basic: [
+ "user": {
+ "User documentation": [
  {
- type: 'autogenerated',
- dirName: 'basic',
- }
- ],
- Navigation: [{
- type: 'autogenerated',
- dirName: 'navigation',
- }],
- Entities: [
- {
- type: 'autogenerated',
- dirName: 'entities',
- }
- ],
- Categories: [
+ "type": "autogenerated",
+ "dirName": "user"
+ },
  {
- type: 'autogenerated',
- dirName: 'categories',
- }
- ],
+ "Download": [
+ {
+ "type": "autogenerated",
+ "dirName": "setup"
+ }
+ ]
+ },
+ {
+ "Configuration": [
+ {
+ "type": "autogenerated",
+ "dirName": "configuration"
+ }
+ ]
+ },
+ {
+ "Categories": [
+ {
+ "type": "autogenerated",
+ "dirName": "categories"
+ }
+ ]
+ },
+ {
+ "Usage": [
+ {
+ "type": "autogenerated",
+ "dirName": "basic"
+ }
+ ]
+ },
+ {
+ "Entities": [
+ {
+ "type": "autogenerated",
+ "dirName": "entities"
+ }
+ ]
+ },
+ {
+ "Navigation": [
+ {
+ "type": "autogenerated",
+ "dirName": "navigation"
+ }
+ ]
+ },
+ "community_guides"
+ ]
  },
- setup: {
- Setup: ['setup/prerequisites', 'setup/download'],
- Configuration: ['configuration/basic', 'configuration/options'],
- Remove: ['setup/remove'],
+ "publisher": {
+ "Publisher documentation": [
+ {
+ "type": "autogenerated",
+ "dirName": "publisher"
+ },
+ {
+ "type": "autogenerated",
+ "dirName": "publish"
+ }
+ ]
  },
- 'developer documentation': {
- 'HACS Development': [
+ "developer": {
+ "Developer documentation": [
  {
- type: 'autogenerated',
- dirName: 'developer',
+ "type": "autogenerated",
+ "dirName": "developer"
  }
- ],
- 'Publish to HACS': [
- 'publish/start',
- 'publish/appdaemon',
- 'publish/integration',
- 'publish/plugin',
- 'publish/python_script',
- 'publish/theme',
- 'publish/include',
- 'publish/action',
- 'publish/remove',
- ],
+ ]
  },
- FAQ: [
+ "faq": {
+ "FAQ": [
  {
- type: 'autogenerated',
- dirName: 'faq',
- },
- ],
-}
+ "type": "autogenerated",
+ "dirName": "faq"
+ }
+ ]
+ }
+} 

src/pages/index.js

@@ -82,9 +82,9 @@ function Home() {
  'button button--outline button--secondary button--lg btt',
  styles.indexButton,
  )}
- to={useBaseUrl('docs/basic/getting_started')}
+ to={useBaseUrl('docs/publisher')}
  >
- USE
+ PUBLISH
  </Link>
  </div>
  </div>