Linebreaks in FAQ section

[ccprog]

The FAQ section shows all linebreaks from the readme.txt instead of interpreting them according to Markdown rules. Related to #2622?

[ccprog]

From ​https://wordpress.org/plugins/crosswordsearch/

[obenland]

Patch would replace line breaks with a space to mitigate instances where line breaks appear after commas of periods.
This is likely not the best approach, maybe there is a setting in our markdown parser that deals with that?

[dd32]

I think I looked into something like 2638.diff​, but unfortunately IIRC it had unintended consequences (which I can't recall now that it's been so long) - probably specifically about intentional new lines.

Here's how that readme was parsed in the old directory:

<p>There is limited support for use in multisite environments. There is no option for a network
wide installation; the plugin <strong>must</strong> be enabled for each individual site. Projects and
their associated rights are also specific to the individual site, local administrators have
access to these settings as usual.</p>

Here's the readme being parsed in the new directory:

<p>There is limited support for use in multisite environments. There is no option for a network
wide installation; the plugin <strong>must</strong> be enabled for each individual site. Projects and
their associated rights are also specific to the individual site, local administrators have
access to these settings as usual.</p>

I'm assuming that the difference is that we now have WordPress display filters running over the content - probably wpautop() specifically.

I think I'm okay with this, and am happy to intentionally break anyone who is reliant upon this specific markdown format of new lines. A bunch of plugins will need to update to match the new directory in many ways, I don't see this as being one of those ways as being a bad thing.
If we leave it as-is, it'd probably be best to add a nl2br() call into the parser to solidify that we're intentionally doing this.

[dd32]

I think I looked into something like 2638.diff​, but unfortunately IIRC it had unintended consequences (which I can't recall now that it's been so long) - probably specifically about intentional new lines.

Looks to be [4386]

[jdgrimes]

I'm seeing this in the plugin descriptions as well (​https://wordpress.org/plugins/wordpoints/):

Related: #2257 ?

[tellyworth]

Absent a patch that doesn't cause other issues, I think the correct solution is not to use explicit newlines in readme.txt.