Legibility is not the concern. The issue is whether the point the docs are making are the actual point the author is concerned with.