a few doc, but a doc effort is needed for pes

Beginnig to give answers to issue #1