improve documentation

fixes #1391

and add improvements/fixes to documentation
You are not using `GlyphRenderer` anywhere...