langreiter.com plain, simple: vanilla-linking-guidelines

LANGREITER.COM plain, simple

START

INDEX

vanilla-documentation : vanilla-linking-guidelines

CREATED BY chris • LAST EDITED BY chris 8238 days AGO

When the heck to link from A to B (and from B to C)?

Using links, you build the structure of a VanillaSpace. The quality of your linking will therefore determine the quality of your knowledge structure.

Use links sparingly.
A snip shouldn't be linked to more than about 7 other snips. If it does, refactor - introduce subcategories, distribute content over multiple snips etc. In the beginning, e.g., the "Vanilla" snip contained a lot of links to documentation snips which were soon refactored to their own snip, "vanilla-documentation".
Be as specific as possible.
If you could link to either "1979" or "1979-09", link to "1979-09". If you could link to either "MIT" or "MIT Media Lab", link to "MIT Media Lab". Avoid linking to concepts too generic/big like "World", "Universe" or "1984".
Refactor wildly.
Just like in programming, refactoring can massively enhance, clear and clean up the structure of your creations. So do it.
Let Vista guide you.
VanillaVista is a great tool for building accessible knowledge structures. If a Vista vista is cluttered, the probability that your link structure could be improved is very high.