DOCS: improved docs for core and especially the new Clocks