DOC: improvements