DAMON development mailing list
 help / color / mirror / Atom feed
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

  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