"Advent of Technical Writing" is a great idea. Looking forward to reading the whole series.
In general it's very helpful to study lots of docs sites to get fresh ideas about different ways to order docs. But I also recommend being careful about apples-to-oranges comparisons. The intuitive ordering for a narrow Python math library is probably different than the intuitive ordering for a sprawling web framework, for example.
In general it's very helpful to study lots of docs sites to get fresh ideas about different ways to order docs. But I also recommend being careful about apples-to-oranges comparisons. The intuitive ordering for a narrow Python math library is probably different than the intuitive ordering for a sprawling web framework, for example.