description -> summary (#1242)

[azaroth42]

Closes #1242 ; replaces description with summary throughout.

[azaroth42]

Failure is an unrelated link checker 4xx/5xx. ( #1329 )

[zimeon]

Maybe I was hasty with review --- the example shows ONE summary not in an array. Do we want to allow more than one, I don't see why that is helpful but if we do allow multiple then perhaps we need client guidelines as to what to do (concatenate?)

[azaroth42]

Hasty with comment? It's a language map, so multiple values would be per language key in the map :)

[zimeon]

Then the text is unclear -- I read "one or more summarys" to mean "one or more summary properties, each of which is a language map"

[zimeon]

This ties with a second comment I wondered about -- should we avoid pluralizing property names by instead saying "summary properties" which also makes it clear which thing has a given cardinality.

[azaroth42]

We'll have the same issue with all languageMap fields ... so should create a new issue to resolve consistently?