Backslash \ is not standard markdown syntax for paragraph

[hdamker]

Problem description

While backslash \ is supported in GitHub for hard line breaks it might be not supported in all tools. For paragraph separation double line breaks are more portable.

Also URLs in the links are split with \ which should be kept on one line. The backslash approach might cause issues where:

• Some parsers show the literal \ character
• URLs might break if the parser doesn't handle the line continuation
• The formatting might not be consistent across different tools

Expected action

For paragraph separation just use double line breaks.

• It's the most portable and widely supported
• It creates clean paragraph separation
• It renders consistently across different OpenAPI viewers (Swagger UI, ReDoc, etc.)
• It's the simplest and most readable in the source

Keep URLs on one line

Additional context

[FabrizioMoggio]

@hdamker, about the URL in one line, I suppose the 80 chars limits is not valid anymore :-)

[hdamker]

@hdamker, about the URL in one line, I suppose the 80 chars limits is not valid anymore :-)

I'm not even aware of a 80 chars limit, looking on most of the descriptions in the APIs

[FabrizioMoggio]

@hdamker, about the URL in one line, I suppose the 80 chars limits is not valid anymore :-)

I'm not even aware of a 80 chars limit, looking on most of the descriptions in the APIs

It was a check in MegaLinter at the very beginnig

[FabrizioMoggio]

Fixed with: #196