docs: add documentation for mdx pages and update images for the overview section (#915)

* docs: update images and document how to add content to our docs

docs: update images and edit text for all intro pages

docs: clean up all pages in the general overview section

docs: add description for Ideas, projectManagement and promotion (#829)

docs: ✏️ Add dark mode README logo (#741)

Co-authored-by: Leah Wasser <[email protected]>
Co-authored-by: Jim Madge <[email protected]>

* enh(image): bring in dark mode compatible logo

* docs: tidy adding images section

Move path alias section up and adjust

Apply suggestions from code review

Co-authored-by: Jim Madge <[email protected]>

* style: linting fixes for emoji table and other content

---------

Co-authored-by: Jim Madge <[email protected]>
Co-authored-by: Jim Madge <[email protected]>

Author: lwasser

astro.config.mjs

@@ -30,17 +30,17 @@ export default defineConfig({
               {
                   label: 'Specification',
                   items: [
-                      { label: 'overview', slug: 'overview' },
+                      { label: 'spec overview', slug: 'overview' },
                       { label: 'specification', slug: 'specification' },
                       { label: 'emoji-key', slug: 'emoji-key' },
-                      { label: 'repository-maintainers', slug: 'repository-maintainers' },
+                      { label: 'usage tips', slug: 'usage-tips' },
                       { label: 'tooling', slug: 'tooling' }
                   ],
               },
               {
                   label: '@all-contributors Bot 🤖',
                   items: [
-                      { label: 'overview', slug: 'bot/overview' },
+                      { label: 'bot overview', slug: 'bot/overview' },
                       { label: 'installation', slug: 'bot/installation' },
                       { label: 'usage', slug: 'bot/usage' },
                       { label: 'configuration', slug: 'bot/configuration' },
@@ -50,7 +50,7 @@ export default defineConfig({
               {
                   label: 'CLI',
                   items: [
-                      { label: 'overview', slug: 'cli/overview' },
+                      { label: 'CLI overview', slug: 'cli/overview' },
                       { label: 'installation', slug: 'cli/installation' },
                       { label: 'usage', slug: 'cli/usage' },
                       { label: 'configuration', slug: 'cli/configuration' }
@@ -60,14 +60,20 @@ export default defineConfig({
                   label: 'Project',
                   items: [
                       { label: 'contribute', slug: 'project/contribute' },
+                      { label: 'development', slug: 'project/development' },
                       { label: 'code-of-conduct', slug: 'project/code-of-conduct' },
-                      { label: 'implementations', slug: 'project/implementations' }
+                      { label: 'implementations', slug: 'project/implementations' },
                   ],
               },
           ],
           }), sitemap()],
 
   vite: {
     plugins: [tailwindcss()],
+    resolve: {
+      alias: {
+        '@assets': '/src/assets',
+      },
+    },
   },
 });