improving documents and tests