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]

Reply via email to