docs: new documentation for framework methods. Refs #916