No, not screen shots...
What does a screen shot of a programming library look like? Is it a photo of a screen with the source code on it? :lol:
What I mean is graphical illustrations of how things work.
Let's take rendering a sprite, for instance.
How many coordinate systems are at work here? How do they relate to each other? What am I doing to which one when I set Sprite.SetCenter, or any of the other possibilities SFML gives me?
How do I get from that drawing of a teddy bear that I made in paint, to that scaled, centered, and rotated 30 degrees counter-clockwise around its tail version in the SFML view port? How do I know in advance whether its nose will be sticking out of the screen?
A couple of nice illustrations could explain all this nicely, I believe.
For an example of how such an illustration might look, take a look at chapter 3 "Multiple coordinate systems" in 3D Math Primer by Fletcher Dunn and Ian Parberry, if you have that available.
But that is not the only subject that could do with graphical illustration. Another nice thing would be an overview of everything that is SFML, and how they go together. A graphical illustration of all the parts of SFML, and their relations.
Pretty much every part of the documentation could be improved with imagery.
It may not mean much to you, but many people learn things faster, gain a deeper understanding, and remember things better, if there is a simple graphical illustration to go along with the text. They are not meaningless fluff, but graphical explanations.
I really believe this could open up your library for many more people, especially beginners.