Instructions for creating authors are not complete

[georgik]

The documnet https://developer.espressif.com/pages/contribution-guide/content-writing-workflow/#add-youself-as-an-author is not accurate. It does not explain expected content of index.md.

The minimal version should be:

---
title: Juraj Michálek
---

The problem is that if you put there just name: instead of title, then the user name won't be visible at Authors page.

[FBEZ]

I agree with Juraj, I had to create the first content a few weeks back and even if it's possible to look around files and folder and figure out how to do, it can be easier.

I would change these lines in the article to make it a little more verbose.

Below an example. If you like, I could create a PR.

---

In other cases, add yourself as an author.
You need to

1. Create your author entry
2. Add your personal data
3. (optional) Add your picture.
4. Reference yourself as an author in the article

Create your author entry

You need to create your personal page at content/authors/<author-name>/_index.md
hugo create content/authors/<author-name>/_index.md

Open the file and enter the

---
title: "John Doe"
---

Add author data

The data is stored as json at data/authors/<author-name>.json. Create the file and add

{
    "name": "John Doe",
    "image": "img/authors/john-doe.webp",
    "bio": "Espressif enthusiast",
    "social": [
        { "linkedin": "https://www.linkedin.com/in/..." },
        { "twitter": "https://x.com/..." }
    ]
}

Add your picture

If you like to add your picture (shown at the beginning of the article) you can add a webp portrait at assets/img/authors/john-doe.webp

Reference yourself as an author

In your article's YAML front-matter, add the following lines

showAuthor: false         # Hide default Espressif author
authors:
  - "<author-name>"        # List your name(s)

---

(BTW The link is now changed to https://developer.espressif.com/pages/contribution-guide/writing-content/#add-youself-as-an-author. )