git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH] Specify UK English for the documentation source files.

From
Marc Branchaud <marcnarc@xiplink.com>
Date
Jul 30, 2013, 15:11 UTC
Message-ID
<1375197114-10742-1-git-send-email-marcnarc@xiplink.com>
In-Reply-To
<51F7D2FA.7020208@xiplink.com>

This will hopefully avoid questions over which spelling and grammar should be used. Translators are of course free to create localizations for other English dialects.

Signed-off-by: Marc Branchaud <marcnarc@xiplink.com>
---

Although I'm Canadian I figured en_CA would be a little too parochial. I don't have a strong preference for en_UK over en_US though.

On 13-07-30 11:05 AM, Junio C Hamano wrote:> 
> I'd rather not to see any change that turns one accepted form into
> another accepted form at all (like "parseable" vs "parsable" in this
> patch).  For that purpose, asking "What is parseable" to Google and
> seeing if there is a hit is good enough ;-)

I think choosing a dialect for git will help mitigate such changes. But perhaps it's a bit too draconian.

		M.
 Documentation/CodingGuidelines | 3 +++
 1 file changed, 3 insertions(+)
diff --git a/Documentation/CodingGuidelines b/Documentation/CodingGuidelines
index 559d5f9..43af82e 100644
--- a/Documentation/CodingGuidelines
+++ b/Documentation/CodingGuidelines
@@ -242,6 +242,9 @@ Writing Documentation:
  processed into HTML and manpages (e.g. git.html and git.1 in the
  same directory).
 
+ The human lanuage of the documentation source files is UK English (en_UK).
+ Please follow UK English norms for spelling and grammar.
+
  Every user-visible change should be reflected in the documentation.
  The same general rule as for code applies -- imitate the existing
  conventions.  A few commented examples follow to provide reference
-- 
1.8.3.1
Previous: Junio C HamanoNext: Fredrik Gustafsson
Message 4 of 12 in “Documentation: fix typos in man pages”
  1. Documentation: fix typos in man pagesØystein Walle, Jul 29, 2013
  2. Marc BranchaudJul 30, 2013
  3. Junio C HamanoJul 30, 2013
  4. Specify UK English for the documentation source files.Marc Branchaud, Jul 30, 2013
  5. Fredrik GustafssonJul 30, 2013
  6. Junio C HamanoJul 30, 2013
  7. Provide some linguistic guidance for the documentation.Marc Branchaud, Aug 1, 2013
  8. Marc BranchaudAug 1, 2013
  9. Junio C HamanoAug 1, 2013
  10. Provide some linguistic guidance for the documentation.Marc Branchaud, Aug 1, 2013
  11. Jonathan NiederAug 2, 2013
  12. Marc BranchaudAug 2, 2013

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.