Skip to content

Commit 7cee8ce

Browse files
HeyItsGilbertclaude
andcommitted
docs(authors): add profile contribution guide + Gilbert Sanchez profile
CONTRIBUTING.md gains an "Adding Your Author Profile" section covering the slug rule, new-author.ps1, the gravatar_hash recipe, and renames. Adds the first real profile (gilbert-sanchez), using gravatar_hash to keep the email out of the repo. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1 parent 1f2aa1a commit 7cee8ce

2 files changed

Lines changed: 73 additions & 0 deletions

File tree

CONTRIBUTING.md

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,68 @@ If you're not comfortable with Git, you can pitch or submit your article through
5757
- Include a brief intro that tells readers what they'll learn
5858
- Test any code examples before submitting
5959

60+
## Adding Your Author Profile
61+
62+
Once you've been credited as an author, you can give yourself a richer profile page at
63+
`/authors/<your-name>/` — an avatar, a tagline, social links, and a bio. Profiles are
64+
**opt-in**: if you don't add one, your name still works as a byline exactly as before.
65+
66+
Your profile lives in a single file at `content/authors/<slug>/_index.md`, where `<slug>`
67+
**must** match your name as it appears in articles' `authors:` front matter (lowercased,
68+
spaces become hyphens, punctuation dropped — e.g. `Jane Doe``jane-doe`). Getting the
69+
slug wrong creates a page that attaches to nothing, so let the helper script do it:
70+
71+
```powershell
72+
./tools/new-author.ps1 "Jane Doe"
73+
```
74+
75+
This scaffolds `content/authors/jane-doe/_index.md` with every field commented. Fill in
76+
what you want and delete the rest:
77+
78+
```yaml
79+
---
80+
title: "Jane Doe" # required — keep this as your byline name
81+
preferred_name: "Jane" # optional — changes only how your name is displayed
82+
tagline: "Cloud automation, mostly."
83+
# --- Avatar (first one set wins) ---
84+
# avatar: "/images/authors/jane.jpg" # an image you host in this repo
85+
gravatar_hash: "..." # MD5 of your lowercased email — keeps your email private
86+
# email: "jane@example.com" # convenient, but stored publicly in this repo
87+
# --- Links (full URLs) ---
88+
github: "https://github.com/janedoe"
89+
website: "https://janedoe.dev"
90+
# twitter / mastodon / linkedin / bluesky also supported
91+
---
92+
93+
Your bio in Markdown goes here. It shows on your profile page.
94+
```
95+
96+
### Choosing an avatar
97+
98+
The avatar is resolved in this order: `avatar``gravatar_hash``email` → an
99+
auto-generated identicon. To use [Gravatar](https://gravatar.com/) without putting your
100+
email in the repo, store the **MD5 hash** of your lowercased email instead:
101+
102+
```powershell
103+
$email = "jane@example.com"
104+
[System.BitConverter]::ToString(
105+
[System.Security.Cryptography.MD5]::Create().ComputeHash(
106+
[System.Text.Encoding]::UTF8.GetBytes($email.Trim().ToLowerInvariant())
107+
)
108+
).Replace("-", "").ToLowerInvariant()
109+
```
110+
111+
### Changed your name?
112+
113+
If your byline ever needs to change across all your content (and your profile URL), use:
114+
115+
```powershell
116+
./tools/new-author.ps1 "Old Name" -To "New Name"
117+
```
118+
119+
This rewrites the byline everywhere it appears and adds a redirect so your old profile
120+
URL keeps working. Open a PR with the result.
121+
60122
## Submitting a Community Event
61123

62124
Add your PowerShell-related event to our community calendar:
Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
title: "Gilbert Sanchez"
3+
tagline: "PowerShell community contributor and module author"
4+
gravatar_hash: "8a5f80a8824ba8c72c0295b000476718"
5+
github: "https://github.com/HeyItsGilbert"
6+
---
7+
8+
Gilbert Sanchez is a systems engineer who spreads the love of PowerShell at scale and
9+
is active across the community, including episodes of The PowerShell Podcast. He writes
10+
PowerShell modules for work and play — find his RPG-flavored modules **RPGDice** and
11+
**BeneathTheCanals** on the [PowerShell Gallery](https://www.powershellgallery.com/).

0 commit comments

Comments
 (0)