Eine Doku ist wie eine Bewerbung:
Die ersten 1..3 Sätze sollten das Interesse wecken, also beschreiben, was Deine Lib macht und für was sie gut ist. So kann hier bereits ein Anwender entscheiden ob er sie überhaupt nutzen will.
Erst in den nächsten Abschnitten beschreibst Du das wie. Und das ist auch einer Bewerbung ähnlich, der Anwender soll daran sehen, wie er mit Deiner Lib seine bisherigen Prozesse vereinfachen kann.
MfG