[core] Top level haddock comments updated