Draft of changes and use of new features

New features docs, check me please for clarity.