From e9ccf5aba24705c525b43ffa611dabe9cd374d27 Mon Sep 17 00:00:00 2001
From: Rich Trott <rtrott@gmail.com>
Date: Wed, 10 Apr 2024 16:08:39 -0700
Subject: [PATCH] doc: accommodate upcoming stricter .md linting
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

remark-lint-final-definition@4.0.0 will start flagging footnotes in
BUILDING.md. I don't think we want to move them to the bottom, so I've
disabled the lint rule where relevant.

Ref: https://github.com/nodejs/remark-preset-lint-node/pull/511
PR-URL: https://github.com/nodejs/node/pull/52454
Refs: https://github.com/nodejs/remark-preset-lint-node/pull/511
Reviewed-By: Yagiz Nizipli <yagiz.nizipli@sentry.io>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Michaël Zasso <targos@protonmail.com>
Reviewed-By: Richard Lau <rlau@redhat.com>
Reviewed-By: Tobias Nießen <tniessen@tnie.de>
---
 BUILDING.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/BUILDING.md b/BUILDING.md
index 050f74348574de..af9f2fcec7aee2 100644
--- a/BUILDING.md
+++ b/BUILDING.md
@@ -121,6 +121,8 @@ platforms. This is true regardless of entries in the table below.
 | AIX              | ppc64be >=power8 | >= 7.2 TL04                       | Tier 2                                          |                                      |
 | FreeBSD          | x64              | >= 13.2                           | Experimental                                    |                                      |
 
+<!--lint disable final-definition-->
+
 [^1]: Older kernel versions may work. However official Node.js release
     binaries are [built on RHEL 8 systems](#official-binary-platforms-and-toolchains)
     with kernel 4.18.
@@ -147,6 +149,8 @@ platforms. This is true regardless of entries in the table below.
 [^5]: Our macOS x64 Binaries are compiled with 11.0 as a target. Xcode 13 is
     required to compile.
 
+<!--lint enable final-definition-->
+
 ### Supported toolchains
 
 Depending on the host platform, the selection of toolchains may vary.
@@ -173,6 +177,8 @@ Binaries at <https://nodejs.org/download/release/> are produced on:
 | linux-x64               | RHEL 8 with gcc-toolset-10[^6]                                                                              |
 | win-x64 and win-x86     | Windows Server 2022 (x64) with Visual Studio 2022                                                           |
 
+<!--lint disable final-definition-->
+
 [^6]: Binaries produced on these systems are compatible with glibc >= 2.28
     and libstdc++ >= 6.0.25 (`GLIBCXX_3.4.25`). These are available on
     distributions natively supporting GCC 8.1 or higher, such as Debian 10,
@@ -183,6 +189,8 @@ Binaries at <https://nodejs.org/download/release/> are produced on:
     distributions natively supporting GCC 9.3 or higher, such as Debian 11,
     Ubuntu 20.04.
 
+<!--lint enable final-definition-->
+
 #### OpenSSL asm support
 
 OpenSSL-1.1.1 requires the following assembler version for use of asm