added advanced usage docs [skip ci]
Merge branch '1.0' docs [skip ci]