Update plenum API and documentation

Improve plenum API and update documentation and tests.