Add missing javadocs and note about registry mutability