glossary

From IndieWeb


A glossary is a part of a post or site that defines terms used therein, usually as part of a footer, sometimes as a separate page on a site, and occasionally sprinkled into sidebar content.

If you’re looking for a glossary of IndieWeb terms, that’s the IndieWeb wiki itself! If you want to help improve the IndieWeb "glossary" as it were, see:

Why

Using an explicit glossary can avoid the need to hyperlink jargon or other rare or unobvious terms inline, reducing the chance that such hyperlinks may distract from the flow of reading.

How to

Patterns and best practices for post and site glossaries are still being researched and in development. For now, take a look at IndieWeb Examples and Brainstorming sections for ideas and experiment with your own site.

IndieWeb Examples

Brainstorming

  • Glossaries should be formatted similar to their print equivalents
  • Glossaries could use the HTML <dl> <dt> <dd> tags & elements

Posts

Posts about glossaries on posts and sites:

Beware

Deceptive redefinition

Beware of (and please avoid) using a glossary to (somewhat?) misleadingly/manipulatively define terms as something other than what they are commonly used for, or overly broad in scope.

Example of use of a glossary for such an "overly broad" redefinition:

  • 2006-12-06 Kevin Marks in Gowers' biased rhetoric noted the problem of a press release redefining "piracy" far beyond customary accepted uses, and in a misleading way in an attempt to encroach and de-legitimize actual legitimate (and protected) uses.

See Also

  • post footer — for other things that may go into the footer of a post
  • definition — for tips on defining terms for the IndieWeb as a whole