Skip to content

Discussion Docs

This section is for docs that illuminate Au’s underpinnings. The kinds of docs that go here include philosophy and principles, deep dives on design choices, explanations of core concepts, and more.

In terms of the four categories of documentation — which we try to follow — this is also known as “explanation”. It’s most useful when you’re studying, rather than working, and it focuses on theoretical rather than practical knowledge.

Here’s a guide to the main categories.

  • Au Idioms. Usage patterns that are more specific to Au, and can help you get the most out of it.

  • Generic concepts. Ideas that can enhance your effectiveness in working with any units library, or with quantities generally.

  • Implementation details. Concepts and design discussions that help you understand how we made Au. These are less likely to directly make you a more effective user, but they may be of interest for the curious.