first major update to docs