Docs improvements

Some docs improvements solving some issues.
hum... now it makes sence :) thank you