git.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: M Hickford <mirth.hickford@gmail.com>
To: "brian m. carlson" <sandals@crustytoothpaste.net>, git@vger.kernel.org
Cc: Junio C Hamano <gitster@pobox.com>
Subject: Re: [PATCH 0/5] Convert AsciiDoc files to .adoc extension
Date: Mon, 20 Jan 2025 17:55:09 +0000	[thread overview]
Message-ID: <f38cbccd-00d1-47a5-a891-817003785c7d@gmail.com> (raw)
In-Reply-To: <20250120015603.1980991-1-sandals@crustytoothpaste.net>

On 2025-01-20 01:55, brian m. carlson wrote:
> As mentioned in a recent thread, our use of the .txt extension for
> AsciiDoc files prevents most editors from recognizing these files as
> AsciiDoc automatically.  There isn't an editor-independent way to
> override this, so many contributors miss out on syntax highlighting,
> linting functionality, and other editor niceties unless they manually
> override the detection when editing.
> 
> In addition, many forges produce rich (HTML) renderings of AsciiDoc and
> other text formats automatically, but this doesn't happen with plain
> .txt files.

Fantastic. New contributors often start with documentation changes. 
Let's make it as easy as we can for them.

  parent reply	other threads:[~2025-01-20 17:55 UTC|newest]

Thread overview: 19+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2025-01-20  1:55 [PATCH 0/5] Convert AsciiDoc files to .adoc extension brian m. carlson
2025-01-20  1:55 ` [PATCH 1/5] doc: update gitignore for " brian m. carlson
2025-01-20  1:56 ` [PATCH 2/5] editorconfig: add " brian m. carlson
2025-01-20  1:56 ` [PATCH 3/5] gitattributes: mark AsciiDoc files as LF-only brian m. carlson
2025-01-20  1:56 ` [PATCH 4/5] doc: use .adoc extension for AsciiDoc files brian m. carlson
2025-01-20 20:37   ` Jean-Noël Avila
2025-01-20 22:08     ` brian m. carlson
2025-01-20 23:43       ` Junio C Hamano
2025-01-21 21:59         ` Jean-Noël Avila
2025-02-06 20:33   ` M Hickford
2025-02-06 21:14     ` Junio C Hamano
2025-02-06 23:47       ` Junio C Hamano
2025-02-07 17:51       ` D. Ben Knoble
2025-02-07 18:05         ` Junio C Hamano
2025-02-07 18:29           ` Junio C Hamano
2025-02-07 22:54           ` brian m. carlson
2025-01-20  1:56 ` [PATCH 5/5] Remove obsolete ".txt" extensions " brian m. carlson
2025-01-20 17:55 ` M Hickford [this message]
2025-01-20 20:19 ` [PATCH 0/5] Convert AsciiDoc files to .adoc extension D. Ben Knoble

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=f38cbccd-00d1-47a5-a891-817003785c7d@gmail.com \
    --to=mirth.hickford@gmail.com \
    --cc=git@vger.kernel.org \
    --cc=gitster@pobox.com \
    --cc=sandals@crustytoothpaste.net \
    /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;
as well as URLs for NNTP newsgroup(s).