[DOC] REST revisions - intro material and formatting