Sometimes I run across things that impress me by how well laid out and organized they are. This list is woefully incomplete, but perhaps I'll remember this note exists from time to time and update it with new, recently discovered examples. # [[Home Assistant]]'s "[Concepts and Terminology](https://www.home-assistant.io/getting-started/concepts-terminology/)" page A perfect introduction to the [[Lexicon]] of HomeAssistant. Unlike most glossaries, **this page of definitions doesn't assume you know the context**. It's laid out not in alphabetical order, but in order of conceptual importance. Each time one term is used in the defining of another, they are linked. Moreover, each term gets its own heading and section. In each section a **visual** of the relevant part of the software is shown. In most sections, examples are given. And each section is *short*. ![[IMG_1545.jpeg]] > [!tip] An excellent combination > 1. Heading for each term > 2. Don't assume context > 3. Order by importance > 4. Include visuals & examples > 5. Say less # The [Minecraft Wiki]([https://minecraft.wiki](https://minecraft.wiki/)) While [[Wikipedia]] is the undisputed king of wikis, I really like a [[Domain Specific Language|Domain Specific]] wiki. When I recently played through Minecraft for the first time I trolled through the Minecraft Wiki and found it to be incredibly well put together. It uses **[MediaWiki](https://www.mediawiki.org/wiki/MediaWiki)**, which does a lot of the heavy lifting in terms of organization - but the Minecraft community have chosen a great set of standards & practices to include. The [[Infobox]]es are good & consistently used. Most pages & concepts have (& use) an icon or visual pulled straight from the game assets. **** # More ## Source - See body