Added clear and remove to adapter API.
Merge branch 'master' into adapter-remove
Document basics of the adapter API.
Use clear for boolean gate.
Formatting. Ordered adapter methods all the same.
Added remove and clear to operation logger adapter.
Reordered the shared specs a bit.