chore: update docs

gouravkhunger · gouravkhunger · commit ab8076268f55 · 2022-05-25T15:12:05.000+05:30
diff --git a/author/configure-your-profile.md b/author/configure-your-profile.md
@@ -46,6 +46,6 @@ gouravkhunger: # replace gouravkhunger with the username you want
 
 - After your are done, **Remove all the comments** (the `#`s and the text after them)
 
-- Commit your changes make a pull request. 
+- Commit the changes and make a pull request. 
 
 We'll merge your PR as soon as possible and your profile would be visible after about 10 minutes past the merge time, at `https://genicsblog.com/author/<your-username>/`: [example](https://genicsblog.com/author/gouravkhunger/){:target="_blank"}.
diff --git a/author/creating-a-draft.md b/author/creating-a-draft.md
@@ -18,7 +18,7 @@ Prerequisites:
 
 ---
 
-The content at genicsblog.com is written in [Markdown](https://en.wikipedia.org/wiki/Markdown){:target="_blank"}. This means that you can write your content in plain text and it will be rendered HTML automatically. Let's create a draft post in markdown!
+The content at genicsblog.com is written in [Markdown](https://en.wikipedia.org/wiki/Markdown){:target="_blank"}. This means that you can write your content in plain text and it will be rendered to HTML automatically. Let's create a draft post in markdown!
 
 ## Create a new file in `_drafts` folder
 
@@ -43,24 +43,27 @@ In the editor, give your file a name. Let's say you want to create a draft title
 
 Genics Blog requires each post/draft to have a frontmatter that defines the title, description, and other metadata. This is declared at the very top of the file within `---` quotations.
 
-Here's an example of a minimal valid frontmatter that Genics Blog understands:
+**Note**: To ease the process explained below, you can use the [frontmatter generator](https://genicsblog.com/tool/frontmatter-generator) tool and copy the generated content to the top of your file.
+
+To manually generate frontmatter, here's an example of a minimal valid frontmatter that Genics Blog understands:
 
 ```yml
 ---
 layout: post
 title:  "How to write a draft"
 excerpt: "The complete guide you'll need to refer to create mind blowing drafts."
-image: "https://cdn.hashnode.com/res/hashnode/image/upload/v1631596605889/xCcnwfFVk.png"
+description: "This is shown to the search engines. If undefined, excerpt is used as the description."
+image: "A url of the hosted image. Paste the image to a comment box on GitHub issues to generate a link quickly."
 hasCode: true
-category: content-writing
-tags: ["writing-skills", "tips"]
+category: coding
+tags: ["blogging", "tips"]
 author: gouravkhunger
 ---
 ```
 
 **Omit any of the variables if you don't want to use them!**
 
-- `layout` defines what kind of page it will be (here, a `post`).
+- `layout` defines what kind of page it will be (for articles, always keep it `post`).
 
 - `title` is the title of the post that will be shown in bold at the blog.
 
@@ -96,29 +99,31 @@ notice: "**Markdown** is supported in this _one_ so you could do [such things](h
 
 After you are done with the frontmatter, you can start writing the content of your post below the `---`.
 
-Check out the [UI Components guide](/author/ui-components) to learn how to add various elements to your post.
+Please read the [UI Components guide](/author/ui-components) to learn how to add various elements to your post.
 
 Also take a look at [other drafts](https://github.com/genicsblog/genicsblog.com/tree/main/_drafts){:target="_blank"} or [published posts](https://github.com/genicsblog/genicsblog.com/tree/main/_posts){:target="_blank"} to take a look at how the content is written.
 
 ## ALERT!
 
-Please **DO NOT** edit any file outside the drafts folder while you are writing your draft, and **DO NOT** change with other author's drafts. This will cause the Pull request checks to fail and your draft won't be automatically published.
+Please **DO NOT** edit any file outside the drafts folder while you are writing your draft, and **DO NOT** change with other author's drafts. This will cause the Pull request checks to fail and delay the review process because of the needed investigation.
 
-Repeated attempts to bypass/hack the check system will result in a permanent ban from the site, the discord community and will result in deletion of your profile.
+Repeated attempts to bypass/hack the CI system will result in a permanent ban from the site, the discord community and will result in deletion of your profile.
 
 ## Previewing the draft
 
-At this point, you'll want to preview how the draft would look like on the site. To do so, commit your finalised changes and make a Pull Request to immediately publish the draft article to the blog. The draft will be published to a private page that is not indexed by search engines.
-
-**A draft is accessible only if someone has its link**. This feature is for the authors to preview their posts before they are published and to share with only those whom they want to.
+At this point, you'll want to preview how the draft would look like on the site.
 
 Once your PR is successfully merged, the draft will appear to a link similar too this:
 
 ```
 https://genicsblog.com/draft/how-to-write-a-draft
 ```
 
-The slug is defined by the name of the file you made. You can preview your changes here, and if needed create new pull requests to publish your changes.
+Replace `how-to-write-a-draft` with the sluggified name of your file.
+
+**A draft is accessible only if someone has its link**. This feature is for the authors to preview their posts before they are published and to share with only those whom they want to.
+
+The slug is defined by the name of the file you made. You can preview your changes here, and if needed create new pull requests to change the content of your draft.
 
 ## Next Steps
 
diff --git a/author/publishing-the-post.md b/author/publishing-the-post.md
@@ -9,10 +9,9 @@ permalink: /author/publishing-the-post
 
 # Publishing the draft post
 
-Once you are assured that your draft is ready, you can publish it. This document provides the steps to do so.
-
 Prerequisites:
 
+- [Create a submission request](/author/create-a-submission-request)
 - [Create a draft post](/author/writing-the-article)
 
 ---
@@ -23,8 +22,12 @@ Once you think the draft is ready, it's the time to go back to the original [iss
 
 We'll go through the draft and make basic edits on grammar, styling, formatting and some SEO related things. Smaller changes will be made without your approval but if we need any clarification, we'll get back to you in the same issue thread.
 
-Once your draft has gone through the review process, the draft file will be moved to the `_posts` folder which will get it published to the blog!
+## Publishing process
+
+Once your draft has gone through the review process, the draft file will be moved to the `_posts` folder under your username which will get it published to the blog! This step is done by our team.
+
+We'll notify you on the same issue thread and mark it closed once the article is live on the site.
 
 Congrats on getting your post published to the [Genics Blog](https://genicsblog.com){:target="_blank"}!
 
-It is now live and you can share it with the world. People could add comments to the post to which you can add replies. Remember to use your full name to in the **Name** field to get identified as the author of the post in the comments section.
+It is now live and you can share it with the world. We will [tweet](https://twitter.com/genicsblog) about your article within a week!
diff --git a/author/submission-request.md b/author/submission-request.md
@@ -42,3 +42,5 @@ In this section, you can share some additional information if you wish to.
 ---
 
 Once you submit a request, someone from the Genics team would respond if you can start working on the initial draft of the article!
+
+In the meantime, you can get familiar with the [UI components](/author/ui-components) that can be used in the article.
diff --git a/index.md b/index.md
@@ -8,7 +8,7 @@ permalink: /
 
 # Welcome
 
-Welcome to the Genics Blog documentation! This documentation is the ultimate guide you need to refer to for publishing content at the [Genics Blog](https://genicsblog.com){:target="_blank"}.
+Welcome to the Genics Blog documentation! This documentation is the ultimate guide you need to refer to become a contributor at the [Genics Blog](https://genicsblog.com){:target="_blank"}.
 
 ## Terminology
 
@@ -18,7 +18,7 @@ Throughout this documentation, you'll find specific words whose meanings are as
 
 - **Blog**: Refers to the [Genics Blog](https://genicsblog.com){:target="_blank"}.
 
-- **Author**: A person who contributes content to the blog. Each author gets their own unique page at `https://genicsblog.com/author/<username>`.
+- **Author**: A person who contributes content to the blog. Each author gets their own unique page at `https://genicsblog.com/author/<username>/`.
 
 - **Repository**: (unless otherwise specified) The GitHub page at which the [code for the blog](https://github.com/genicsblog/genicsblog.com){:target="_blank"} is hosted.
 
@@ -36,4 +36,4 @@ Check out these resources:
 
 ---
 
-A list of open tasks can be found at the [Contribute page](https://genicsblog.com/contribute){:target="_blank"}. All kind of contributributions are heartily welcome!
+A list of open tasks can be found at the [Contribute page](https://genicsblog.com/contribute){:target="_blank"}. All kind of contributions are heartily welcome!
