You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -75,6 +76,28 @@ Generates English and Chinese technical blog posts from PostgreSQL mailing list
75
76
| Chinese | Professional 中文 technical writing, natural terminology (不要直译) |
76
77
| Both | Code blocks with syntax highlighting; links to docs/references |
77
78
79
+
## SQL examples convention
80
+
81
+
**Default:** If the thread topic can reasonably be illustrated with **SQL** (new/changed functions, syntax, `EXPLAIN`, DDL, GUCs demonstrable in SQL, query patterns, regression-test-style snippets from patches), include a **dedicated subsection** with one or more examples in **both** the English and Chinese posts. Readers expect copy-pasteable snippets.
82
+
83
+
**What to include**
84
+
85
+
- Fenced blocks with `sql` syntax highlighting.
86
+
- Examples grounded in the thread or attachments (e.g. `strings.sql` / `uuid.sql` from patches, or minimal repros of discussed behavior).
87
+
- Short comments on **expected shape of results** or **version/commit requirements** when the feature is not in a released PostgreSQL yet—avoid implying examples run on every existing install without a caveat.
88
+
89
+
**When to skip**
90
+
91
+
- The discussion is purely internal (e.g. executor internals with no user-visible SQL), or SQL would be misleading or enormous. In those cases, C snippets or prose are enough; do not force SQL.
92
+
93
+
**Placement**
94
+
95
+
- Usually under **Technical Analysis** or **Technical Details** (e.g. `### SQL examples` / `### SQL 示例`); keep EN and CN structurally aligned.
96
+
97
+
**Parity**
98
+
99
+
- Chinese and English posts should carry the **same** examples (same statements; comments may be localized).
100
+
78
101
## Terminology (Chinese)
79
102
80
103
When writing the Chinese version, use these standard translations:
Copy file name to clipboardExpand all lines: BLOG_GENERATION_PROMPT.md
+1Lines changed: 1 addition & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -36,6 +36,7 @@ I need you to act as a PostgreSQL expert and technical writer to generate a high
36
36
- **Technical Analysis:**
37
37
- Key discussion points and decisions
38
38
- Code examples or patch highlights (if relevant)
39
+
- **SQL examples:** When the topic can be shown with SQL (functions, DDL, queries, `EXPLAIN`, patterns from regression tests), add a subsection with copy-pasteable `sql` blocks in **both** English and Chinese; include version/caveats if needed. Skip only when SQL would be misleading or not applicable—see `SQL examples convention` in `.cursor/skills/pgweekly-blog-generation/SKILL.md`.
39
40
- Evolution of the solution (compare patch versions if multiple exist)
0 commit comments