chore: content parity and url fixes (#3)

* check account/

* codacy-ai/

* codacy-api/ and routing fixes

* codacy-guardrails/

* coverage-reporter/

* gettings-started/ reviewed + support languages revamp

* faq/code-analysis

* faq/repositories

* faq/troubleshooting

* faq/general

* repositories

* repositories-configure/

* organizations/

* fixing urls

* added chart/ folder + fixed chart urls

* fixing charts/ components and urls

* fix last url errors

* fix urls with id attributes

* url fixes

Author: claudiacodacy

docusaurus/README.md

@@ -6,12 +6,14 @@ This website is built using [Docusaurus](https://docusaurus.io/), a modern stati
 
 ```bash
 yarn
+or npm install
 ```
 
 ## Local Development
 
 ```bash
 yarn start
+or npm start
 ```
 
 This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
@@ -20,22 +22,11 @@ This command starts a local development server and opens up a browser window. Mo
 
 ```bash
 yarn build
+or npm run build
 ```
 
 This command generates static content into the `build` directory and can be served using any static contents hosting service.
 
 ## Deployment
 
-Using SSH:
-
-```bash
-USE_SSH=true yarn deploy
-```
-
-Not using SSH:
-
-```bash
-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.
+Handled by GitHub actions into Github Pages.

docusaurus/docs/_includes/AdminAccessControlInfo.mdx

@@ -1,3 +1,3 @@
 :::note
-Organization admins can [manage access to this feature](/organizations/roles-and-permissions-for-organizations#change-analysis-configuration)
+Organization admins can [manage access to this feature](/organizations/roles-and-permissions-for-organizations.mdx#change-analysis-configuration)
 :::

docusaurus/docs/_includes/ApiExamplePaginationImportant.mdx

@@ -1,3 +1,3 @@
 :::caution
-[Learn how to use pagination](/codacy-api/using-the-codacy-api#using-pagination) to ensure that you process all results returned by the API.
+[Learn how to use pagination](/codacy-api/using-the-codacy-api.mdx#using-pagination) to ensure that you process all results returned by the API.
 :::

docusaurus/docs/_includes/ServiceAccountIntegration.mdx

@@ -6,5 +6,5 @@ which may happen when a user leaves the team or the organization.
 
 For more information and instructions on how to set up a dedicated
 service account see  
-[Why did Codacy stop commenting on pull requests?](/faq/troubleshooting/why-did-codacy-stop-commenting-on-pull-requests#outdated-permissions)
+[Why did Codacy stop commenting on pull requests?](/faq/troubleshooting/why-did-codacy-stop-commenting-on-pull-requests.mdx#outdated-permissions)
 :::

docusaurus/docs/account/emails.mdx

@@ -6,7 +6,7 @@ To manage the email addresses associated with your account and your email notifi
 
 ![Email settings](images/emails-notifications.png)
 
-## Updating your email addresses ||updating||
+## Updating your email addresses \{#updating\}
 
 Codacy automatically links to your Codacy account the email addresses from the Git provider associated with your current session. On the **Emails** page, you can verify which email addresses are linked to your Codacy account.
 
@@ -32,7 +32,7 @@ To update the email addresses associated with your Codacy account, do the follow
     When developers commit **from GitHub or Bitbucket**, Codacy automatically associates all the commit email addresses from the same Git provider user with a single Codacy committer. For developers that never logged in to the Codacy app, this mechanism requires that they [set their Git email address](#git-config) and add all their email addresses to their [GitHub account](https://github.com/settings/emails) or [Bitbucket account](https://bitbucket.org/account/settings/email/).
 :::
 
-### Setting your Git email address ||git-config||
+### Setting your Git email address \{#git-config\}
 
 Unless you explicitly [configure your email address](https://git-scm.com/docs/git-config#Documentation/git-config.txt-useremail), Git automatically uses an email address based on the username and hostname of your workstation, and associates this email address with your commits.
 

docusaurus/docs/account/managing-your-profile.mdx

@@ -20,11 +20,11 @@ To manage your profile information such as your name and avatar, click on your a
 When you delete your account on Codacy:
 
 -   Your profile information and all data related to your personal repositories are completely removed from Codacy
--   Codacy will [stop analyzing any repositories added to Codacy using your account](../faq/troubleshooting/why-did-codacy-stop-commenting-on-pull-requests.md) {/*!--NOTE See https://github.com/codacy/docs/pull/1354#discussion_r950190842 for more context -->*/}
+-   Codacy will [stop analyzing any repositories added to Codacy using your account](../faq/troubleshooting/why-did-codacy-stop-commenting-on-pull-requests) {/*!--NOTE See https://github.com/codacy/docs/pull/1354#discussion_r950190842 for more context -->*/}
 
 This operation doesn't make any changes on your Git provider.
 
 To delete your account, click the button **Delete account** and confirm that you <span class="skip-vale">really</span> want to proceed.
 
 :::note
-If you're the last organization admin of any of your organizations, you must either add someone else as an owner or [delete those organizations](../organizations/what-are-organizations.md#deleting-an-organization) before you can delete your account.
+If you're the last organization admin of any of your organizations, you must either add someone else as an owner or [delete those organizations](../organizations/what-are-organizations.mdx#deleting-an-organization) before you can delete your account.

docusaurus/docs/chart/_order.ts

@@ -0,0 +1,55 @@
+export const chartOrder = [
+    'chart/index',
+    'chart/requirements',
+    {
+        type: 'category' as const,
+        label: 'Setting up Kubernetes',
+        items: [
+            'chart/infrastructure/eks-quickstart',
+            'chart/infrastructure/microk8s-quickstart'
+        ],
+    },
+    {
+        type: 'category' as const,
+        label: 'Configuring Codacy',
+        items: [
+            {
+                type: 'category' as const,
+                label: 'Integrations',
+                items: [
+                    'chart/configuration/integrations/github-cloud',
+                    'chart/configuration/integrations/github-enterprise',
+                    'chart/configuration/integrations/github-app-create',
+                    'chart/configuration/integrations/gitlab-cloud',
+                    'chart/configuration/integrations/gitlab-enterprise',
+                    'chart/configuration/integrations/bitbucket-cloud',
+                    'chart/configuration/integrations/bitbucket-server',
+                    'chart/configuration/integrations/email'
+                ]
+            },
+            'chart/configuration/caching',
+            'chart/configuration/monitoring',
+            'chart/configuration/logging'
+        ],
+    },
+    {
+        type: 'category' as const,
+        label: 'Maintenance and operations',
+        items: [
+            'chart/maintenance/license',
+            'chart/maintenance/upgrade',
+            'chart/maintenance/uninstall',
+            'chart/maintenance/database'
+        ],
+    },
+    {
+        type: 'category' as const,
+        label: 'Troubleshooting',
+        items: [
+            'chart/troubleshoot/troubleshoot',
+            'chart/troubleshoot/logs-collect',
+            'chart/troubleshoot/k8s-cheatsheet'
+        ],
+    },
+];
+      

docusaurus/docs/chart/assets/images/codacy-logo.svg

@@ -0,0 +1,5 @@
+:::tip
+To see the version of your Codacy Self-hosted instance click your avatar on the top right-hand corner of any Codacy page: 
+
+![Obtaining the Codacy Self-hosted version](./images/self-hosted-version.png)
+:::