update docs, warnings