Merge pull request #3 from dhub-dev/update-blog-and-docs-content

Update Blog and Docs Content

Author: argshook

blog/2024-01-20-how-it-works/index.mdx

@@ -1,33 +1,44 @@
 ---
 slug: how-it-works
 title: Learn How Docusaurus Works
-authors: [personX]
+authors: [wonderful-person]
 tags: [dhub, docusaurus, features]
 ---
 
 # Learn How Docusaurus Works
 
-This page is your gateway to understanding the essential features that make your blog tick. Get ready to explore the key elements that make Docusaurus a powerful tool for bloggers.
+This page is your gateway to understanding the essential features of
+Dhub and Docusaurus.
 
 ### Framework
 
-[Docusaurus blogging features](https://docusaurus.io/docs/blog) are powered by the [blog plugin](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-content-blog). Simply add Markdown files (or folders) to the `blog` directory. The blog post date can be extracted from filenames, such as:
+Blog is powered by the [blog plugin](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-content-blog). Simply add Markdown files (or folders) to the `blog` directory. The blog post date can be extracted from filenames, such as:
 
 - `2024-01-21.md`
-- `2024-01-21-how-it-works/index.md`
+- `2024-01-21-how-it-works/index.mdx`
 
 ### Page structure
 
-Docusaurus relies on _frontmatter variables_ to generate the blog post page. Instead of using the Heading-1 level title from the content, it extracts information from these variables:
+Docusaurus relies on _frontmatter variables_ to generate the blog post page.
+
+Some information is used from variables at the start of the file, here's an example of the frontmatter structure:
 
 ```
+---
 slug: page-url-slug
-title: The title Docusaurus uses to show in a page
-authors: [ceo, arijus]
+title: The title to show in a page
+authors: [wonderful-person]
 tags: [any, words, here, become, tags]
+---
+
+## The content of the page starts here
 ```
 
-Understanding this structure ensures a cohesive layout for your blog pages, allowing for a personalized and organized reader experience.
+:::tip
+
+Dhub supports the frontmatter structure and provides a user-friendly interface to manage it.
+
+:::
 
 ### Images
 
@@ -37,11 +48,11 @@ Explore two ways to add visuals to your blog:
 
    Keep your images in a centralized folder. Upload them to `/static/img/`:
 
-   [![A closeup shot of rocks](/img/rocks.jpg 'A photo by Nick Nice')](https://unsplash.com/photos/shallow-focus-photography-of-gravels-zwjSCTItiZU)
+   [![A closeup shot of rocks](/img/rocks.jpg "A photo by Nick Nice")](https://unsplash.com/photos/shallow-focus-photography-of-gravels-zwjSCTItiZU)
 
 2. **Next to the Post File**
 
-   Place your images next to the post file. For example, `plants.png` can be stored next to the `index.md` file in the `2024-01-20-how-it-works` folder:[![A closeup shop of plants](./plants.jpg 'A photo by Nahil Naseer')](https://unsplash.com/photos/green-leaf-plants-xljtGZ2-P3Y)
+   Place your images next to the post file. For example, `plants.png` can be stored next to the `index.md` file in the `2024-01-20-how-it-works` folder:[![A closeup shop of plants](./plants.jpg "A photo by Nahil Naseer")](https://unsplash.com/photos/green-leaf-plants-xljtGZ2-P3Y)
 
 ## Truncate
 
@@ -51,26 +62,30 @@ Limit the size of your blog posts in the list view using a `<!-- truncate -->` c
 
 ## React components
 
-Docusaurus supports interactive components as part of the post's content. For example, if you insert this code block in Dhub's **embedded MDX** component:
+Dhub supports interactive components as part of the post's content. For example, if you insert this code block in Dhub's **embedded MDX** component:
 
 ```js
-<button onClick={() => alert('button clicked!')}>Click me!</button>Tags
+<button onClick={() => alert('You clicked me!')}>Click me!</button>Tags
 ```
 
 In the published site, it will show this element:
 
 ```mdx-code-block
-<button onClick={() => alert('button clicked!')}>Click me!</button>
+<button onClick={() => alert('You clicked me!')}>Click me!</button>
 ```
 
 ## Tags
 
-Tagging system enhances the organization of your posts, making it easy for readers to explore content based on their interests.
+Tagging let's you organize blog posts into categories. This makes it easy for readers to explore content based on their interests.
 
-Create new tags by adding them as _frontmatter variables_ at the start of the file:
+To create new tags, add them as _frontmatter variables_ at the start of the file:
 
 ```
+---
 tags: [tag 1, tag 2, tag 3]
+---
+
+## The content of the page starts here
 ```
 
 ## Authors
@@ -79,8 +94,14 @@ Understand how authors are managed through the `blog/authors.yml` file, ensuring
 
 :::note
 
-At the moment, Dhub editor doesn't support opening this file; it has to be configured outside the Dhub editor.
+Editing this file in Dhub editor is coming soon!
 
 :::
 
-Learn about the `authors.yml` file structure at Docusaurus documentation: [Docusaurus Blog Documentation - Global Authors.](https://docusaurus.io/docs/blog#global-authors)
+To learn about the `authors.yml` file, see [Docusaurus documentation](https://docusaurus.io/docs/blog#global-authors)
+
+:::tip
+
+Need more hands-on assistance? Hop on our [Discord server](https://discord.gg/6qGnyrt7xy).
+
+:::

blog/2024-01-21.md

@@ -1,60 +1,60 @@
 ---
 slug: welcome
 title: Welcome to Your Blog!
-authors: [ceo, arijus]
+authors: [val, arijus]
 tags: [dhub, hello, docusaurus]
 ---
 
 # **Welcome to Your Blog!**
 
-## Getting Started with Dhub and Docusaurus
+Greetings from Dhub the team! 👋
 
-Greetings, blogger! 🚀 Welcome to Dhub, your all-in-one online editor designed for crafting beautiful blogs using the powerful Docusaurus framework.
+Welcome to [Dhub](https://dhub.dev), your all-in-one markdown editor for [Docusaurus](https://docusaurus.io/) framework.
 
-## Navigating Your Blogging Space
+We are thrilled to have you on board and can't wait to see the amazing content you create!
 
-As you embark on your blogging adventure, this initial page serves as your welcome hub. Here, you can find essential information about Dhub, including helpful tips and guidelines to kickstart your blogging journey. The intuitive editor interface is designed to enhance your writing experience, making it both enjoyable and efficient.
+## 1 minute tutorial
 
-## How to Use Dhub
+### Add content
 
-1. **Add Components:**
+Type `/` to reveal a list of available components.
+Select one, like `Heading 1` or `Image` and it to the document.
 
-   - Type "/" in the editor to reveal a list of available Docusaurus components.
+### Create a New Blog Post
 
-   - Select the desired component to add it to your blog post.
+- Click **"•••"** on the **"blog"** folder in the sidebar and choose **"New file..."**.
+- Give it a name like a date of the post like `2024-05-01` and hit enter. Dhub will add `.mdx` suffix automatically.
 
-2. **Editing Made Easy:**
+![](/img/tutorial.jpg)
 
-   - Click on any component to modify its content.
+:::tip
 
-   - Utilize the toolbar for additional [_formatting_](#) options.
+Dhub supports both `.md` and `.mdx` although `.mdx` is more versatile.
 
-3. **Create New Blog Posts:**
+:::
 
-   - Click **"•••"** on the **"blog"** folder in the sidebar to open a contextual menu.
+### Push to Github
 
-   - Choose **"New file..."** to create a new page.
+Hit the "Push to Github" at the top right.
 
-   - Give it a name and hit enter. If the file format isn't specified, Dhub will create a .mdx file.
+Dhub automates all the necessary steps to put your content on GitHub. No need to learn `git`.
 
-   - Dhub supports .md and .mdx files.![](/img/tutorial.jpg)
+### Publish on the web
 
-4. **Push to Github:**
+For publishing, we recommend using external platforms like [Vercel](https://vercel.com/) or [Netlify](https://www.netlify.com/). They seamlessly integrate with Docusaurus.
 
-   - Hit the "Push to Github" button to store your changes outside Dhub.
+You can publish to Vercel right from Dhub.
 
-5. **Publish your blog:**
+## What's next
 
-   - For publishing, we recommend using external platforms like [Netlify](https://www.netlify.com/) or [Vercel](https://vercel.com/), which seamlessly integrate with Docusaurus.
+Jump to **[2024-01-20-how-it-works](2024-01-20-how-it-works/index.mdx)** file to learn the best practices.
 
-## Understanding Docusaurus
+Dhub is here to support your blogging and documentation journey every step of the way.
 
-Dhub harnesses the capabilities of Docusaurus, a modern open-source documentation framework by Facebook. It enables you to build and maintain a clean, organized, and feature-rich blog with ease.
+Happy blogging!
 
-:::note Learn more
+:::tip
 
-Go to **"[2024-01-20-how-it-works.md](2024-01-20-how-it-works/index.mdx)"** file to learn the best practices using Docusaurus.
+Need more hands-on assistance? Hop on our [Discord server](https://discord.gg/6qGnyrt7xy).
 
 :::
-
-Remember, your creativity knows no bounds, and Dhub is here to support your blogging journey every step of the way. Happy blogging!

blog/authors.yml

@@ -1,16 +1,16 @@
-ceo:
+val:
   name: Val Repšys
   title: CEO @ Dhub
-  url: https://github.com/vrepsys
+  url: https://dhub.dev/
   image_url: https://avatars.githubusercontent.com/u/1429012
 
 arijus:
   name: Arijus Šukys
-  title: Super Engineer @ Dhub
-  url: https://github.com/argshook
+  title: Engineer @ Dhub
+  url: https://dhub.dev/
   image_url: https://avatars.githubusercontent.com/u/4284659
 
-personX:
+wonderful-person:
   name: A wonderful person
-  title: First Dhub customer
-  image_url: https://images.unsplash.com/photo-1588080064985-cb6ae38645bc?q=80&w=2500&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D
+  title: That's you!
+  image_url: https://images.unsplash.com/photo-1588080064985-cb6ae38645bc?q=80&w=2500&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D

docusaurus.config.js

@@ -8,8 +8,8 @@ import { themes as prismThemes } from "prism-react-renderer";
 
 /** @type {import('@docusaurus/types').Config} */
 const config = {
-  title: "Exploring the Digital Frontier",
-  tagline: "A Comprehensive Journey into Docusaurus Documentation",
+  title: "Your docs with Dhub",
+  tagline: "Collaborative WYSIWYG editor for your Docusarus site",
   favicon: "img/favicon.ico",
 
   // Set the production url of your site here
@@ -20,10 +20,10 @@ const config = {
 
   // GitHub pages deployment config.
   // If you aren't using GitHub pages, you don't need these.
-  organizationName: "facebook", // Usually your GitHub org/user name.
-  projectName: "docusaurus", // Usually your repo name.
+  organizationName: "dhub-dev", // Usually your GitHub org/user name.
+  projectName: "template-docusaurus", // Usually your repo name.
 
-  onBrokenLinks: "throw",
+  onBrokenLinks: "warn",
   onBrokenMarkdownLinks: "warn",
 
   // Even if you don't use internationalization, you can use this field to set
@@ -43,15 +43,13 @@ const config = {
           sidebarPath: "./sidebars.js",
           // Please change this to your repo.
           // Remove this to remove the "edit this page" links.
-          editUrl:
-            "https://github.com/facebook/docusaurus/tree/main/packages/create-docusaurus/templates/shared/",
+          editUrl: "https://github.com/dhub-dev/template-docusaurus/tree/main",
         },
         blog: {
           showReadingTime: true,
           // Please change this to your repo.
           // Remove this to remove the "edit this page" links.
-          editUrl:
-            "https://github.com/facebook/docusaurus/tree/main/packages/create-docusaurus/templates/shared/",
+          editUrl: "https://github.com/dhub-dev/template-docusaurus/tree/main",
         },
         theme: {
           customCss: "./src/css/custom.css",
@@ -75,74 +73,58 @@ const config = {
             label: "Docs",
           },
           { to: "/blog", label: "Blog", position: "left" },
-          { to: "/about-page", label: "About", position: "left" },
+          { to: "/about", label: "About", position: "left" },
         ],
       },
       footer: {
         style: "light",
         links: [
           {
-            title: "Docusaurus Community",
             items: [
               {
-                label: "Stack Overflow",
-                href: "https://stackoverflow.com/questions/tagged/docusaurus",
-              },
-              {
-                label: "Discord",
-                href: "https://discordapp.com/invite/docusaurus",
+                label: "Documentation",
+                href: "/docs",
               },
               {
-                label: "Twitter",
-                href: "https://twitter.com/docusaurus",
-              },
-            ],
-          },
-          {
-            title: "Docusaurus Resources",
-            items: [
-              {
-                label: "Documentation",
-                href: "https://docusaurus.io/docs/blog",
+                label: "Blog",
+                href: "/blog",
               },
               {
-                label: "GitHub",
-                href: "https://github.com/facebook/docusaurus",
+                label: "About",
+                href: "/about",
               },
             ],
           },
+
           {
-            title: "Dhub Resources",
+            title: "Dhub",
             items: [
               {
-                label: "Application",
+                label: "App",
                 href: "https://dhub.dev",
               },
               {
-                label: "Documentation",
-                href: "https://docs.dhub.dev",
+                label: "Website",
+                href: "https://dhub.dev",
               },
             ],
           },
+
           {
-            title: "Site links",
+            title: "Support",
             items: [
               {
-                label: "Documentation",
-                href: "/docs",
-              },
-              {
-                label: "Blog",
-                href: "/blog",
+                label: "Discord",
+                href: "https://discord.gg/6qGnyrt7xy",
               },
               {
-                label: "About",
-                href: "/about-page",
+                label: "GitHub",
+                href: "https://github.com/dhub-dev",
               },
             ],
           },
         ],
-        copyright: `Copyright © ${new Date().getFullYear()} Blog Website, Inc. Built with Docusaurus, edited with Dhub`,
+        copyright: `Copyright © ${new Date().getFullYear()} Blog Website, Inc. Edited with Dhub on Docusaurus`,
       },
       prism: {
         theme: prismThemes.github,