This is an automated email from the ASF dual-hosted git repository.
morningman pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/doris-website.git
The following commit(s) were added to refs/heads/master by this push:
new 0a8b4b022c2 [doc](blog) Add editorial checks for converted articles
(#4646)
0a8b4b022c2 is described below
commit 0a8b4b022c2738c2b91e90b6852e02e19b8fd433
Author: Mingyu Chen (Rayner) <[email protected]>
AuthorDate: Sun Nov 15 14:54:19 2026 +0800
[doc](blog) Add editorial checks for converted articles (#4646)
Converted posts now require a final review of the English article to
emphasize reader priorities and link up to 10 distinct keywords to Doris
or other authoritative documentation. The checklist keeps bold text
selective, prevents duplicate keyword links and destination URLs, and
distinguishes body links from front matter keywords.
Validation: `git diff --check` passed. No site build was run, as
required by the guide.
## Versions
- [ ] dev
- [ ] 4.x
- [ ] 3.x
- [ ] 2.1 or older (not covered by version/language sync gate)
Not applicable: this change updates a contributor workflow guide under
`doc-tools/`, with no product documentation changes.
## Languages
- [ ] Chinese
- [x] English
## Docs Checklist
- [x] Checked by AI
- [ ] Test Cases Built
- [x] Updated required version and language counterparts, or explained
why not
- [x] If only one language changed, confirmed whether source/translation
counterparts need sync
This guide has no versioned or localized counterpart to synchronize.
Test cases are not applicable to this Markdown-only change.
Co-authored-by: morningman <[email protected]>
---
doc-tools/HOW-TO-ADD-BLOG.md | 7 +++++++
1 file changed, 7 insertions(+)
diff --git a/doc-tools/HOW-TO-ADD-BLOG.md b/doc-tools/HOW-TO-ADD-BLOG.md
index 60e7012a0a8..8ac35a131b4 100644
--- a/doc-tools/HOW-TO-ADD-BLOG.md
+++ b/doc-tools/HOW-TO-ADD-BLOG.md
@@ -180,6 +180,13 @@ Put the complete article body after the license comment.
The page already render
Keep the source article's heading hierarchy, links, code blocks, tables,
lists, and other Markdown content in this file. Update image references as
described in the next section. Do not add the imports used by external-link
stubs. A `<!-- truncate -->` marker is not required because the Blog list uses
the front matter `summary`.
+### Final editorial checks for converted articles
+
+When converting an article from another source for publication here, complete
both checks after the final English draft is ready:
+
+- [ ] Read and analyze the final English article, then selectively bold the
information readers care about most, such as the problem in a specific use
case, the solution, and the resulting benefits. Emphasize short, meaningful
phrases or sentences. Keep bold text sparse so the key points stand out; avoid
bolding entire paragraphs or every mention of a term.
+- [ ] Select no more than 10 distinct keywords in the article body, such as
key features or technical terms, and link them to relevant Apache Doris
official documentation or other authoritative documentation. Prefer the
specific documentation page that explains the term, and verify that each
destination is accessible and relevant. Link each selected keyword only once,
and do not repeat the same destination URL for different keywords. Count
existing keyword links toward this limit. These [...]
+
## Step 6: Add images
Create one image directory for the article:
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]