can we expand the documentation to include these changes?