From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-dy1-f175.google.com (mail-dy1-f175.google.com [74.125.82.175]) (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 1C2AA384232 for ; Tue, 13 Oct 2026 00:37:08 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=74.125.82.175 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1791851830; cv=none; b=CuaHMHDHn8oF3YcYFwEEKMmKOZGhCWOP/nIXOp5hQQpQZ2do0DXtGrRq8Nn+bJMABL2Nt5BseGuPWF7vIBHUGDx0yJKfMCzTZOdj2R7+EPIX8QyU8Pt0AwCb+JSLyYuCTBeT2PNfJygNnyuPWzpv/SRgppIl9ALBrij3xJ8rPdE= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1791851830; c=relaxed/simple; bh=L+dE0/hU4ZNeQxjs73nhw3WwEUtYeGTvqOmMgoIXmfY=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=W3oxXitHibdbiwXPKB5/xwiFa35dreXnT3RS2izhMp3fLQmKOCtmAf2RNRoUaiQq1QI3gmM8h9oRWTPa+nKNEZTD00pFpGIrZ+Trtblc/xZjBVkQ8dxhmrAhb2dL/f6Dd2sFgspO6/IqkSSrcjEzxhdDbecM1DbwVf4Bn5M59zg= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=AXH4xXFD; arc=none smtp.client-ip=74.125.82.175 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="AXH4xXFD" Received: by mail-dy1-f175.google.com with SMTP id 5a478bee46e88-35aa0cf7c40so1668840eec.1 for ; Mon, 12 Oct 2026 17:37:08 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1791851828; x=1792456628; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to:content-type; bh=0VkHgqdUHzUGSmNMiwrINvUMy6OmGz5QxPOiyM5hWps=; b=AXH4xXFD2wkppEQI08cL9Q1tAosO9G5HGPYhcgyp6V3x+vuUCh/Xmo95dGS/lgFj25 2DnoeUeGYcFKE6kU8L9KBaj19/h61dznBnmCeOqzFicNWkyDW2iAykHcqMLj9a35Dxjo 7dlbZHwNP7V00YpelsUN2qC6qdJNbD1efrq7CfqFSyXKhmALikT6KdCUM2wMub3o94wq 8oXFDrCeUotv7ScXhOwxwXbHKGKoeozvcn/Dn1+OXIsdOFrWNcQ+UJXYjaMIxmUV7iPJ EUUUmFFOtdemPmqVaJTnqJrT/qkYHWUPuIel0mWXffSbStg+5mud53FBQLaaU72qugpG 3U1A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20260707; t=1791851828; x=1792456628; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to:content-type; bh=0VkHgqdUHzUGSmNMiwrINvUMy6OmGz5QxPOiyM5hWps=; b=2IZm6BAdc/VOXtTRE/0U+WMPC2YsypkPJEgn+LI+z8AbsBcUIoOFjMBEREVcRG6vJx KHxffdMzlCocR4OiozS+vkmuDVel5N4ryVAZNiRMpXv5+wBCgrqLJh55stKWEHlEGY+m /Gvg0RF4wLEHqMuNtBHJmzbwQXNd9F0zz1Y0YfxpC4RFxUO4P16lCX2c1nWGesd4n4kY ptJH0alDLnoqVaeJ5I63MHCSJ9F5RmUlgsucu+i6wPWo4FsMcfDr40Vp3lx6zz+dZXky 0o+xuLkC63Lv6vi6f8sbewZJancQdHY7+aQffMYzoqLatg1hft+66s++/f3QeDZdB19o Wp4g== X-Forwarded-Encrypted: i=1; AKwUvByXFdCW31lwY/UsgekDyA+52b/vzrLrdoirLxtIX+A8zYUXgCmw2x8jtLOtJihBK8iAK4g3WldCDXA=@vger.kernel.org X-Gm-Message-State: AFq9FYJgNUUwdBONRZhbDloZ4CY7y2P3TIYg08sGHuQt+2LMAUVob9nO 8jaTZKKWipkLc2qOx3S8YjYP01x4BcmqYjFBSAs1VXdGEXN3sDvtCn1z X-Gm-Gg: AYBFou03GlEcLSDLZOCVy5XdFqEtgqIvogq/OTEgoa8he7Or+ICwaxLQ6CRTnMKxsd1 AdTZJkWP0ifZDolGsbdUCp706MZcQyQG4b0g9tNigJAP5BpqIph2qY/J/oNNClO57rIYNMoejRH gB2F59O4YzX/xkyrfbDUr62uImr6n6bDSLljQWLgjQnDGQgadxqaP8BpZpLI+Ip8qOfQiYn4dT+ 8+UpGfu88AsEl3Ah29OhmAWxNm/6CGF7NA3DptfGAmQ8S6paHavJPP6MwaQaVTZflDM5YgHf9gk Cw0X/EyDU0bfvs2p03a6V2GJQKI9LYy5tT9Ul+0XF61wHk5Sq97XeUVcR7IdzELRXWQEhz/Zl3O WmCs4AvIBSVJErXqTPnmE//YprhpWgSAefjbdjIpJw7sO4QNVL8fwf0bphdPbYvrBhwlTNgSy37 d4na2LwHJL4tQS9jNuGYCk+/D45RyDxdWZLlAefeC72WbjsVU6Uio+7xckaBXc2DiQIH4R2+aTg IIPsHmZYdyKwO4n2H+rYCj+6gD9e5uWHwjE5Ur7YTyf5Um5JM9GBALyGSX9BK6C+bEa8CRbeN2V J2ellq3m2ZPF3B+ilJkc5Zoe+bBgiLZLcQ== X-Received: by 2002:a05:7300:fe4a:b0:35c:11e2:cf11 with SMTP id 5a478bee46e88-35c11e2d21dmr1684181eec.2.1791851827888; Mon, 12 Oct 2026 17:37:07 -0700 (PDT) Received: from penguin.bbrouter. ([200.218.229.14]) by smtp.gmail.com with ESMTPSA id 5a478bee46e88-3537ca1b556sm49947560eec.9.2026.10.12.17.37.05 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 12 Oct 2026 17:37:07 -0700 (PDT) From: Daniel Pereira To: Jonathan Corbet Cc: Daniel Pereira , Shuah Khan , Randy Dunlap , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 0/2] docs: add a guide for translators Date: Mon, 12 Oct 2026 21:37:00 -0300 Message-ID: <20261013003702.5824-1-danielmaraboo@gmail.com> X-Mailer: git-send-email 2.47.3 Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Jonathan, apologies: an earlier test send of this series reached you by mistake, without the lists in Cc. This is the proper posting; please ignore the previous one. The documentation has seven translations, but the English documentation has no guide on how to contribute to them; the only one that exists, Documentation/translations/zh_CN/how-to.rst, is in Chinese and covers zh_CN only. As a result, the same problems keep coming up in the review of translation patches: labels copied from the original that collide with the English ones, partial builds that hide those collisions, documents left out of any toctree, missing commit descriptions and missing recipients. Patch 1 adds Documentation/doc-guide/translations.rst, a guide that covers the whole workflow of a translation, from choosing what to translate to sending the patch and keeping the translation up to date. Patch 2 translates the guide into Brazilian Portuguese. Since it is based on the original added by patch 1, whose commit hash is only known once the series is applied, it does not carry the "Update the translation through commit" line that the guide suggests. Both patches were checked with a full "make htmldocs" build, with no new warnings, and with scripts/checkpatch.pl --strict. Daniel Pereira (2): docs: doc-guide: add a guide for translators docs: pt_BR: translate doc-guide/translations.rst Documentation/doc-guide/index.rst | 1 + Documentation/doc-guide/translations.rst | 693 +++++++++++++++++ Documentation/translations/index.rst | 3 + .../translations/pt_BR/doc-guide/index.rst | 19 + .../pt_BR/doc-guide/translations.rst | 709 ++++++++++++++++++ Documentation/translations/pt_BR/index.rst | 11 + 6 files changed, 1436 insertions(+) create mode 100644 Documentation/doc-guide/translations.rst create mode 100644 Documentation/translations/pt_BR/doc-guide/index.rst create mode 100644 Documentation/translations/pt_BR/doc-guide/translations.rst -- 2.47.3