docs: improve add author instructions

Author: f-hollow

archetypes/blog.md

@@ -4,11 +4,11 @@ date: "{{ now.Format "2006-01-02" }}"
 # If default Espressif author is needed, uncomment this
 # showAuthor: true
 # Add a summary
-summary: "Replace it with a brief summary that capture the essence of (1) what the article is about and (2) how the reader will benefit from reading it. For examples, check other article summaries."
-# Create your author entry
+summary: "Replace it with a brief summary that captures the essence of (1) what the article is about and (2) how the reader will benefit from reading it. For examples, check other article summaries."
+# Create your author entry (for details, see https://developer.espressif.com/pages/contribution-guide/writing-content/#add-youself-as-an-author)
 #  - Create your page at `content/authors/<author-name>/_index.md`
 #  - Add your personal data at `data/authors/<author-name>.json`
-#  - Add your author name(s) below
+#  - Add author name(s) below
 authors:
   - "author-name" # same as in the file paths above
 # Add tags

content/pages/contribution-guide/writing-content/index.md

@@ -68,13 +68,40 @@ To add yourself as an author, [create an article](#create-and-view-an-article) a
 
 If the article already exists and you want to edit the authors, here are the same instructions:
 
-- Create your author entry
-  - Create your page at `content/authors/<author-name>/_index.md`
-  - Add your personal data at `data/authors/<author-name>.json`
-- Add the following to your article's YAML header
+- Create your author entry<br>
+  {{< alert >}}
+  Replace all `author-name` and `Author Name` instances below with your own name, for example `john-doe` and `John Doe` respectively
+  {{< /alert >}}
+  - Create your page at `content/authors/author-name/_index.md`
+    ```markdown
+    ---
+    title: Author Name
+    ---
+
+    <!-- (optional) Add a few words about yourself  -->
+    ```
+  - (optional) Add your image in [WebP format](#use-webp-for-raster-images) at the path
+    ```sh
+    assets/img/authors/author-name.webp
+    ```
+  - Add your personal data at `data/authors/author-name.json`<br>
+    (In  `image`, add your image or use the default one: `img/authors/espressif.png`)
+    ```json
+    {
+        "name": "Author Name",
+        "image" : "img/authors/author-name.webp",
+        "bio": "(optional) Your role at Espressif",
+        "social": [
+            { "linkedin": "https://www.linkedin.com/..." },
+            { "github": "https://github.com/..." }
+        ]
+    }
+    ```
+- Add author name(s) to your article's YAML header
   ```yaml
   authors:
-    - "<author-name>"        # List your name(s)
+    - "author-name" # same as in the file paths above
+    - "another-author"
   ```
 
 In some cases, it might be better to add the default Espressif author: