AusDTO / gov-au-content-guide

The draft previous version of the GOV.AU Content Guide. We have moved:
https://github.com/govau/content-guide
Creative Commons Attribution 4.0 International
3 stars 6 forks source link

Paragraph breaks #149

Closed joolswood closed 7 years ago

joolswood commented 8 years ago

What do you need?

What I’m trying to suggest is a move away from talking about paragraphs and instead talking about 'paragraph breaks’.

This is based on my experiences talking about this with writers, who get inevitably get confused and start writing bad sentences because they’re trying to fit some paragraph rule.

What I’m really talking about is presenting text, rather than constructing text.

The websites I see these days that are handling text really cleanly and neatly are putting in a break every 1 or 2 sentences. A paragraph construction rule doesn’t apply because much because nothing’s getting lost inside a block of text any more.

All the text then becomes readable and scannable.

Generally, the content on the Structure your page for readability could also be made plainer.

Which entry/section is this related to?

http://content-style-guide.apps.staging.digital.gov.au/az-indexes/p.html#paragraphs http://content-style-guide.apps.staging.digital.gov.au/writing-for-the-web/3-structure-your-page-for-readability.html

joolswood commented 7 years ago

Please can someone add the wording here that was discussed in the Content Clinic.

joolswood commented 7 years ago

Hi @michaelhugill please can you add some text around this.

AndrewArch commented 7 years ago

Beg to differ on the readability/scanability aspect - don't artificially insert 'paragraph breaks' every few sentences, if I understood @joolswood correctly. Keep the idea within a single paragraph - rewrite the paragraph if it seems too long!

joolswood commented 7 years ago

Review text with these changes:

joolswood commented 7 years ago

From @libbyv:

Short paragraphs make it easier to read text on mobile screens.

Try limiting paragraphs to 1 to 2 sentences. Or break up the text into bullet points to improve readability.
joolswood commented 7 years ago

https://github.com/govau/content-guide/issues/36