From 7ee9ceafa11d64f921f10cdbd8bc28b1b1a93597 Mon Sep 17 00:00:00 2001 From: Joseph Hale Date: Sat, 26 Apr 2025 11:31:23 -0700 Subject: [PATCH] feat: Remove persona headings The "Visitors" and "Maintainers" headings were my first attempt to clarify the difference in intended audiences for each part of the announcement. But those headings only make sense if the reader thinks of himself/herself as a "visitor" or a ",maintainer". Removing the "visitor" heading immediately places more focus on the content of the announcement since there's no longer an extraneous heading. Replacing the "Maintainers" heading with "Add this badge to your project" both makes the section more actionable, and subtley opens the invitation to individuals who don't think of themselves as "maintainers". --- archetypes/default.md | 2 -- content/no-maintenance-intended/index.md | 2 -- content/purely-personal/index.md | 2 -- layouts/shortcodes/maintainer_instructions.md | 4 +--- 4 files changed, 1 insertion(+), 9 deletions(-) diff --git a/archetypes/default.md b/archetypes/default.md index 4c1ca75..97960c9 100644 --- a/archetypes/default.md +++ b/archetypes/default.md @@ -9,8 +9,6 @@ draft = true name = "badge" +++ -## Visitors - Thanks for your interest in using open-source software! You're probably here because a project linked to this page. diff --git a/content/no-maintenance-intended/index.md b/content/no-maintenance-intended/index.md index db88a69..4056695 100644 --- a/content/no-maintenance-intended/index.md +++ b/content/no-maintenance-intended/index.md @@ -8,8 +8,6 @@ type = "psa" name = "badge" +++ -## Visitors - Thanks for your interest in using open-source software! You're probably here because a project linked to this page. diff --git a/content/purely-personal/index.md b/content/purely-personal/index.md index b888cd8..250247e 100644 --- a/content/purely-personal/index.md +++ b/content/purely-personal/index.md @@ -8,8 +8,6 @@ type = "psa" name = "badge" +++ -## Visitors - Thanks for your interest in using open-source software! You're probably here because a project linked to this page. diff --git a/layouts/shortcodes/maintainer_instructions.md b/layouts/shortcodes/maintainer_instructions.md index 5e712ce..ed894f3 100644 --- a/layouts/shortcodes/maintainer_instructions.md +++ b/layouts/shortcodes/maintainer_instructions.md @@ -3,9 +3,7 @@ {{ $article_url := ( absURL $slug ) }} {{ $badge_url := ( absURL ( printf "%s%s" $slug "/badge.svg" ) ) }} -## Maintainers - -Here's how to add the badge for this Public Service Announcement to your README +## Add this badge to your project [![](badge.svg)]({{ $article_url }}) -- 2.51.2