HTML: fix pre's incomplete description

[PassionPenguin]

Description

<pre> will drop the first blank line (if exists) immediately following its start tag.

Motivation

per @Josh-Cena's comment #37384 (comment)

Additional details

<pre>'s HTML documentation: https://html.spec.whatwg.org/multipage/grouping-content.html#the-pre-element

[github-actions]

Preview URLs

• /en-US/docs/Web/HTML/Element/pre

Flaws (23)

URL: /en-US/docs/Web/HTML/Element/pre
Title: <pre>: The Preformatted Text element
Flaw count: 23

• macros:
  • Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Learn/HTML
  • Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Learn/Getting_started_with_the_web/HTML_basics
  • Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Learn/HTML/Introduction_to_HTML
  • Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Learn/HTML/Introduction_to_HTML/Getting_started
  • Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Learn/HTML/Introduction_to_HTML/The_head_metadata_in_HTML
  • and 18 more flaws omitted

External URLs (1)

URL: /en-US/docs/Web/HTML/Element/pre
Title: <pre>: The Preformatted Text element

• https://en.wikipedia.org/wiki/Monospaced_font (1 time) (Note! This may be a new URL 👀)

(comment last updated: 2025-01-13 10:42:18)

[chrisdavidmills]

Thanks for the great work, as always, @PassionPenguin!

So, for this one, I think your first conflict concern is OK — the wording provided is "represents preformatted text which is to be presented exactly as written". I think the stripping of the first blank line is intended to help with this — authors will appreciate being able to write their element content on separate lines to the opening and closing tags without having to worry about the leading newline character.

Also, note that the text following this line qualifies the exact behavior, so I think we are all good here. If you are still worried, you could maybe update "represents preformatted text which is to be presented exactly as written" to "represents preformatted text intended to be presented exactly as written", to signify that this is what the intent is, rather than the exact behavior?

For your second concern, I think this is valid — the whitespace line looks to be in conflict with your addition. To fix this, I would put the whitespace line into its own paragraph and combine it with your note, which I don't think needs to be a note.

So the second paragraph would read:

Whitespace inside this element is displayed as written, with one exception. If one or more leading newline characters are included immediately following the opening <pre> tag, the first newline character is stripped.

Let me know what you think. Thanks again!

[PassionPenguin]

Thanks for the great work, as always, @PassionPenguin!

So, for this one, I think your first conflict concern is OK — the wording provided is "represents preformatted text which is to be presented exactly as written". I think the stripping of the first blank line is intended to help with this — authors will appreciate being able to write their element content on separate lines to the opening and closing tags without having to worry about the leading newline character.

Also, note that the text following this line qualifies the exact behavior, so I think we are all good here. If you are still worried, you could maybe update "represents preformatted text which is to be presented exactly as written" to "represents preformatted text intended to be presented exactly as written", to signify that this is what the intent is, rather than the exact behavior?

For your second concern, I think this is valid — the whitespace line looks to be in conflict with your addition. To fix this, I would put the whitespace line into its own paragraph and combine it with your note, which I don't think needs to be a note.

So the second paragraph would read:

Whitespace inside this element is displayed as written, with one exception. If one or more leading newline characters are included immediately following the opening \<pre\> tag, the first newline character is stripped.

Let me know what you think. Thanks again!x

Your suggestions are reasonable and awesome, and I'd updated the content to go with your suggestion!

Thanks for your review~!

[chrisdavidmills]

@PassionPenguin Perfect; let's get this merged. Thanks again!