[HelpHub] Feedback on Verse block

[zzap]

URL of the Page with the Issue

https://wordpress.org/documentation/article/verse-block/

Report content (issue description) its author

Please update this documentation to explain why one would choose a verse block over a paragraph block for writing poetry.

For example on this website

they explain succinctly

The Verse block is for writing poetry, song lyrics or other literary expressions. Unlike the paragraph block, it leaves all spaces and line breaks untouched.

In general with components (and programming at large) developers should explain why they wrote the code so people can understand its purpose and use it accordingly.

By https://profiles.wordpress.org/toomanyphils/

[github-actions[bot]]

Heads up @WordPress/docs-issues-coordinators, we have a new issue open. Time to use 'em labels.

[karthick-murugan]

Suggested Update for the Verse Block Documentation:

Why Use the Verse Block?

The Verse block is specifically designed for writing poetry, song lyrics, or other literary expressions. Unlike the Paragraph block, the Verse block preserves all spaces and line breaks exactly as you enter them. This makes it ideal for content where formatting, such as indentation or line breaks, is critical to the meaning or presentation.

Example Use Cases:

Poetry: Maintain the structure of stanzas and verses.

Song Lyrics: Preserve the formatting of choruses and verses.

Literary Excerpts: Keep the original spacing and line breaks intact.

Comparison with the Paragraph Block:

The Paragraph block automatically adjusts spacing and line breaks to fit the design of your theme, which is great for standard text but not ideal for poetry or lyrics.

The Verse block, on the other hand, respects your exact formatting, ensuring your creative work is displayed as intended.

[github-actions[bot]]

Heads up @docs-reviewers - the "[Status] Review" label was applied to this issue.