ai-ml/skills-library
SHA256
14
6
Fork 2
Code Issues 6 Pull requests Projects Activity Actions

♻️ templates(discourse-post): Refine structure from first-use feedback

Browse source 
Update the Discourse post template based on lessons from the first real
use of the Gem (2026-04-21 Docs Team meeting).

Greeting: Replace the fixed "Happy {{DAY_OF_WEEK}}, Fedora folks!" with
a flexible `{{GREETING}}` placeholder that allows natural variation
across posts. This prevents the output from feeling robotic when the
same person posts summaries for multiple teams.

Headings: Downgrade section headings from h1 to h2 with emoji prefixes
(📝, ✅, 📜). In Discourse, h1 is visually overpowering and typically
reserved for the post title. The emoji prefixes improve visual scanning.

Meeting links: Change from bold text label to h2 heading with 🔗 emoji,
consistent with the other section headings.

Placeholders: Update `{{MEETING_DATE}}` to long format,
`{{TEAM_CONTEXT_SENTENCE}}` to allow 1-2 sentences, and
`{{TOPICS_BULLETED_LIST}}` to specify substantive topics only. Remove
`{{DAY_OF_WEEK}}` (absorbed into `{{GREETING}}`).

Assisted-by: Claude Opus 4.6 (1M context)
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
This commit is contained in:
Justin Wheeler 2026-04-22 19:29:17 -04:00
commit 65b8a48a0b
Signed by: jflory7
GPG key ID: 7748B15FA8FA4C7E
1 changed files with 9 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

18
templates/discourse-post.md
View file

@ -20,7 +20,7 @@ Everything below this line is the post body content that will be posted to Fedor
---
Happy {{DAY_OF_WEEK}}, Fedora folks! :waving_hand: Here is a summary of the recent meeting of the **{{TEAM_NAME}}** held on **{{MEETING_DATE}}**.
{{GREETING}} :waving_hand: Here is the summary of the {{MEETING_DATE}}, {{TEAM_NAME}} meeting.
{{TEAM_CONTEXT_SENTENCE}}
@ -31,7 +31,7 @@ _Note: {{AI_TOOL_NAME}} was used to summarize the Meetbot-generated HTML log of
---
**Meeting Links:**
## 🔗 Links to Meeting Logs
- [Text Log]({{TEXT_LOG_URL}})
- [HTML Log]({{HTML_LOG_URL}})
@ -40,15 +40,15 @@ _Note: {{AI_TOOL_NAME}} was used to summarize the Meetbot-generated HTML log of
---
# Executive Summary
## 📝 Executive Summary
{{EXECUTIVE_SUMMARY}}
# Action Items
## ✅ Action Items
{{ACTION_ITEMS_LIST}}
# Detailed Meeting Log
## 📜 Detailed Meeting Log
{{DETAILED_MEETING_LOG}}
@ -58,14 +58,14 @@ _Note: {{AI_TOOL_NAME}} was used to summarize the Meetbot-generated HTML log of
| Placeholder | Description | Source |
|-------------|-------------|--------|
| `{{GREETING}}` | A casual, varied greeting (e.g., "Hey folks!", "Happy Monday, Fedora folks!", "Hi everyone!", "Good morning, Fedora friends!") — vary naturally across posts | Generated by Gem |
| `{{TITLE_OPTION_1}}` | First title suggestion with engaging summary hook | Generated by Gem from meeting content |
| `{{TITLE_OPTION_2}}` | Second title suggestion with alternative hook | Generated by Gem from meeting content |
| `{{TITLE_OPTION_3}}` | Third title suggestion with alternative hook | Generated by Gem from meeting content |
| `{{DAY_OF_WEEK}}` | Day of week the meeting was held (e.g., "Monday") | Derived from meeting date |
| `{{TEAM_NAME}}` | Full name of the team or working group | Extracted from meetbot configuration or meeting header |
| `{{MEETING_DATE}}` | Meeting date in YYYY-MM-DD format | Extracted from meetbot log filename or header |
| `{{TEAM_CONTEXT_SENTENCE}}` | One sentence describing what the team does or current focus | Generated by Gem or configured in team settings |
| `{{TOPICS_BULLETED_LIST}}` | Markdown bulleted list of major topics covered | Generated by Gem from meeting structure |
| `{{MEETING_DATE}}` | Meeting date in long format (e.g., "April 21, 2026") | Extracted from meetbot log filename or header |
| `{{TEAM_CONTEXT_SENTENCE}}` | 1-2 sentences: one describing the team's role in the Fedora Project, one describing this meeting's thematic focus | Generated by Gem from `teams.md` and meeting content |
| `{{TOPICS_BULLETED_LIST}}` | Markdown bulleted list of substantive discussion topics only — exclude announcements, introductions, housekeeping, and minor asides | Generated by Gem from meeting structure |
| `{{AI_TOOL_NAME}}` | Name and version of AI tool used for summarization | System-provided (e.g., "Google Gemini 2.5 Flash") |
| `{{TEXT_LOG_URL}}` | URL to plain text meetbot log | Constructed from meeting date and team identifier |
| `{{HTML_LOG_URL}}` | URL to HTML formatted meetbot log | Constructed from meeting date and team identifier |