Audience
One of Unity’s key principles is democratization: making development available to everybody. Unity documentation is accessible to users of all skill levels and doesn't make assumptions about the reader’s level of knowledge.
Unity documentation has the following two main areas with slightly different target audiences:
- User Manual: A wide target audience of programmers, artists, designers and project managers at all skill levels.
- API reference: Programmers are the primary target audience. It's still important to remember that programmers of all skill levels use the API reference, so keep it clear and easy to follow.
Communication for all skill levels
Users turn to the documentation when they don't know something. Be specific and logical about information, even if it seems obvious from your perspective.
Avoid phrases like "use common sense." Additionally, avoid phrases like "and so on" or "etc." at the end of sentences. This indicates an assumption that the reader already understands the material, and can make the reader feel out of their depth.