From: sashiko-bot@kernel.org
To: "Doehyun Baek" <doehyunbaek@gmail.com>
Cc: damon@lists.linux.dev
Subject: Re: [PATCH v7 4/7] docs/zh_CN: update DAMON start translation
Date: Wed, 12 Aug 2026 07:07:24 +0000 [thread overview]
Message-ID: <20260812070725.1C20B1F000E9@smtp.kernel.org> (raw)
In-Reply-To: <20260812065914.3071433-5-doehyunbaek@gmail.com>
Thank you for your contribution! Sashiko AI review found 2 potential issue(s) to consider:
- [Low] The translation removes a valid cross-reference link to the sysfs documentation that is still present in the English original.
- [Low] The translation introduces a command-line flag (`--target_pid`) not present in the corresponding English documentation.
--
--- Patch [4]: [PATCH v7 4/7] docs/zh_CN: update DAMON start translation ---
commit bbfe3c26ebbdef4a642261a8f53c94379a221924
Author: Doehyun Baek <doehyunbaek@gmail.com>
docs/zh_CN: update DAMON start translation
This commit updates the Chinese translation of the DAMON start documentation
to align with recent upstream changes through commit c9380cdd949d.
> diff --git a/Documentation/translations/zh_CN/admin-guide/mm/damon/start.rst b/Documentation/translations/zh_CN/admin-guide/mm/damon/start.rst
> index cff7b6f98c594..1a7f3382dd158 100644
> --- a/Documentation/translations/zh_CN/admin-guide/mm/damon/start.rst
> +++ b/Documentation/translations/zh_CN/admin-guide/mm/damon/start.rst
> @@ -35,18 +35,63 @@ https://github.com/damonitor/damo找到。下面的例子假设DAMO在你的$PAT
> 这并不是强制性的。
>
> 因为DAMO使用了DAMON的sysfs接口(详情请参考:doc:`usage`),你应该确保
> -:doc:`sysfs </filesystems/sysfs>` 被挂载。
> +``sysfs`` 被挂载。
[Severity: Low]
Does this change break the documentation cross-reference? The English
original still maintains the functional cross-reference to the sysfs
documentation, so replacing it with a plain code literal here creates an
inconsistency and removes the link in the rendered Chinese document.
[ ... ]
> @@ -117,8 +162,8 @@ https://github.com/damonitor/damo找到。下面的例子假设DAMO在你的$PAT
> 数据访问模式感知的内存管理
> ==========================
>
> -以下三个命令使每一个大小>=4K的内存区域在你的工作负载中没有被访问>=60秒,就会被换掉。 ::
> +以下命令使每一个大小>=4K的内存区域在你的工作负载中没有被访问>=60秒,就会被换掉。 ::
>
> - $ echo "#min-size max-size min-acc max-acc min-age max-age action" > test_scheme
> - $ echo "4K max 0 0 60s max pageout" >> test_scheme
> - $ damo schemes -c test_scheme <pid of your workload>
> + $ sudo damo start --damos_access_rate 0 0 --damos_sz_region 4K max \
> + --damos_age 60s max --damos_action pageout \
> + --target_pid <pid of your workload>
[Severity: Low]
Is the --target_pid flag supposed to be added here? The original English
documentation for this section does not include the --target_pid argument
in the command snippet.
If this flag is now required, shouldn't the English original be updated
first rather than introducing it only in the translation?
--
Sashiko AI review · https://sashiko.dev/#/patchset/20260812065914.3071433-1-doehyunbaek@gmail.com?part=4
next prev parent reply other threads:[~2026-08-12 7:07 UTC|newest]
Thread overview: 15+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-08-12 6:59 [PATCH v7 0/7] docs/zh_CN: update DAMON documentation translation Doehyun Baek
2026-08-12 6:59 ` [PATCH v7 1/7] docs/zh_CN: update DAMON design translation Doehyun Baek
2026-08-12 7:02 ` sashiko-bot
2026-08-12 6:59 ` [PATCH v7 2/7] docs/zh_CN: add DAMON_STAT usage translation Doehyun Baek
2026-08-12 7:07 ` sashiko-bot
2026-08-12 6:59 ` [PATCH v7 3/7] docs/zh_CN: update DAMON index translation Doehyun Baek
2026-08-12 7:05 ` sashiko-bot
2026-08-12 6:59 ` [PATCH v7 4/7] docs/zh_CN: update DAMON start translation Doehyun Baek
2026-08-12 7:07 ` sashiko-bot [this message]
2026-08-12 6:59 ` [PATCH v7 5/7] docs/zh_CN: update DAMON usage translation Doehyun Baek
2026-08-12 7:02 ` sashiko-bot
2026-08-12 6:59 ` [PATCH v7 6/7] docs/zh_CN: update DAMON reclaim translation Doehyun Baek
2026-08-12 7:02 ` sashiko-bot
2026-08-12 6:59 ` [PATCH v7 7/7] docs/zh_CN: update DAMON LRU sort translation Doehyun Baek
2026-08-12 7:09 ` sashiko-bot
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20260812070725.1C20B1F000E9@smtp.kernel.org \
--to=sashiko-bot@kernel.org \
--cc=damon@lists.linux.dev \
--cc=doehyunbaek@gmail.com \
--cc=sashiko-reviews@lists.linux.dev \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox