change to flags service, and documentation improvements