From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mta0.migadu.com (out-103.mta0.migadu.com [91.218.175.103]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 91FC2311C32 for ; Fri, 2 Oct 2026 16:51:21 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=91.218.175.103 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1790959883; cv=none; b=SzYL5/B6Lr0cAXVDOKYQMtAJ2aEgUIz4n+uFAKaGXNS/zozlNUZ+kIKjyjBbb/cebiBSPdu2AgcyXhMzDbx54tpDYq5ER5hEEmwpjrlowcu3R0icvDnNLzw4uu6+p99Feb0bB/JrqVyY6W+bd8ZQ3my9WKWd3DRmOlYzoYpiyaM= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1790959883; c=relaxed/simple; bh=/I3TgWx8/U/mtgoPen/cIWwNHyR0DG/ZCxNDvpcPV6s=; h=Date:From:To:Cc:Subject:Message-ID:MIME-Version:Content-Type: Content-Disposition:In-Reply-To; b=S9ZSigFwNYvrRRgNwD8Hx08/xkS6QJFWuCVuxS3O2RSvTkhrkOcL6eBIlNKbAJTwispedjwfwJBxBjDC6H4dVP7h8vV4jpHsQ5Cdq1X9+HUVTfOKOBTu2xvDztQ4lpL/8S1Vg5XmbYqCEVyCSHi+UT5MA8mOgQEPDTsbeglPvyM= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=wyuan.org; spf=pass smtp.mailfrom=wyuan.org; dkim=pass (2048-bit key) header.d=wyuan.org header.i=@wyuan.org header.b=MIjA326L; arc=none smtp.client-ip=91.218.175.103 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=wyuan.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=wyuan.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=wyuan.org header.i=@wyuan.org header.b="MIjA326L" X-Envelope-To: linux-doc@vger.kernel.org DKIM-Signature: a=rsa-sha256; bh=/I3TgWx8/U/mtgoPen/cIWwNHyR0DG/ZCxNDvpcPV6s=; c=simple/simple; d=wyuan.org; h=from:to:subject:date:message-id:mime-version:content-type; s=key1; t=1790959879; v=1; x=1791564679; b=MIjA326LfRybeWPLOwCXnJOHDM3t5kcPUnzr3ctO08xE5O37fZhBLarqJ1cftgyr+b1EKcVe 5y2dt61lgj1rIEZ/mbMnygAIqNV35tudDExef3KUOEFphZThTldCuOQLDvOMqlg+ghZ9GOMzF7y D4UuRP8JR3rdwBZHxnW2XvEsw/Dqiz2plR1W4CyZc7WV3zcxeLyEXKXBa1ZmsZDMBqN+hK6WoGS /7MMKGIbkYd2sbb2eMrePobeD3afrxWCjSMNCvliI+gDoxKCX5S6bMsG8srrPNFjVRxOYHJWEAg x8dPIS3DRXvg7bwKQU7+irlnd4kcZkIdgOVQk1Eo7L8AA== X-Envelope-To: linux-doc@vger.kernel.org Received: by smtp.migadu.com with ESMTPS id 3e530eae1dfef6a4; Fri, 02 Oct 2026 16:51:09 +0000 X-Mizu-Trace-ID: 3e530eae1dfef6a4 X-Migadu-Flow: FLOW_OUT Date: Sat, 3 Oct 2026 00:51:01 +0800 From: Weijie Yuan To: Jani Nikula Cc: Chen-Yu Yeh , corbet@lwn.net, alexs@kernel.org, dzm91@hust.edu.cn, si.yanteng@linux.dev, srcres258@furdevs.cn, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Vegard Nossum Subject: Re: [PATCH 4/4] docs/zh_TW: add missing :Original: fields Message-ID: Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <22fdd310dfb0946bbe58ed71308e58d936cbed53@intel.com> Hi, On 2026-09-29 17:40:18 +0300, Jani Nikula wrote: > On Tue, 29 Sep 2026, Chen-Yu Yeh wrote: > > Every zh_TW translation names the English document it mirrors in an > > :Original: field, except these four. Add one to each, in the plain path > > form that automarkup turns into a link. > > I'm wondering, are these :Original: fields useful anymore since the > translations extension adds the button to switch between languages? > > The pretty much hard-coded expectation is that the English version at > path/to/foo.rst is the original, and its translations are at > translations/xx_YY/path/to/foo.rst. > > I.e. neither the HTML nor the RST benefit from it, and it's just > repetition. On 2026-10-01 17:00:23 +0300, Jani Nikula wrote: > On Wed, 30 Sep 2026, 葉宸佑 wrote: > > You are right, and I should have seen it -- the rest of this series is > > built on that same expectation. checktransupdate.py also finds the > > original purely from the path, which is why 1/4-3/4 move the files > > rather than fix their :Original: fields. By the same token, at their old > > paths the language switcher cannot pair them with their originals > > either, which is a better argument for the moves than the one I gave. > > Oh, by the way, I do think the series as a whole is worthwhile cleanup, > and having the :Original: fields is the current practice. Removing them > should be a separate change. I am a newcomer and might lack contextual information, but I don't see anything rely heavily on this field either? I only find that on March this year, Jon did not expect that the script checktransupdate.py uses this field to get the original file of each translation. So is this a convention or is there some additional circumstance that forces us to keep this field? Hmm, btw, I noticed that the Japanese translations do not have this field. Thanks.