Although it isn't perfect, I put a lot of effort into the docs for my game development framework at https://domeengine.com.

Make sure each document/page has a clear audience, and it's clear to the reader what that audience is, as well as where other audiences should go.