a pit stop before getting fully tested replace{First,All}
finalize new API, tweak DDOCs, more examples