SDL: docs/ Added more content, fixed a typo.

From d57f2afcaf3119b0c00625ac38f6fcccabca14f1 Mon Sep 17 00:00:00 2001
From: "Ryan C. Gordon" <[EMAIL REDACTED]>
Date: Wed, 15 May 2024 14:21:53 -0400
Subject: [PATCH] docs/ Added more content, fixed
 a typo.

 docs/ | 30 +++++++++++++++++++++++++++++-
 1 file changed, 29 insertions(+), 1 deletion(-)

diff --git a/docs/ b/docs/
index 672c3cc043f4f..1471366ddde1c 100644
--- a/docs/
+++ b/docs/
@@ -50,7 +50,7 @@ to that symbol.
 wikiheaders will include those defines in the syntax section of the wiki
 page, and generate stub pages for each define that simply says "please refer
 to (The Actual Symbol You Care About)" with a link. It will also pull in
-any blank lines or most preprocessor directives for the syntax text, too.
+any blank lines and most preprocessor directives for the syntax text, too.
 Sometimes an unrelated define, by itself, just happens to be right below one
 of these symbols in the header. The easiest way to deal with this is either
@@ -263,6 +263,34 @@ examples into discrete C files and attempts to compile them, and complains
 if they don't work.
+## Unrecognized sections are left alone in the wiki.
+A wiki section that starts with `## Section Name` (or `== Section Name ==` in
+MediaWiki format) that isn't one of the recognized names will be left alone
+by wikiheaders. Recognized sections might get overwritten with new content
+from the headers, but the wiki file will not have other sections cleaned out
+(this is how Code Examples remain wiki only, for example). You can use this
+to add Wiki-specific text, or stuff that doesn't make sense in a header, or
+would merely clutter it up.
+A possibly-incomplete list of sections that will be overwritten by changes
+to the headers:
+- The page title line, and the "brief" one-sentence description section.
+- "Deprecated"
+- "Header File"
+- "Syntax"
+- "Function Parameters"
+- "Macro Parameters"
+- "Fields"
+- "Values"
+- "Return Value"
+- "Remarks"
+- "Thread Safety"
+- "Version"
+- "See Also"
 ## It's okay to repeat yourself.
 Each individual piece of documentation becomes a separate page on the wiki, so