#2217 more progress documenting API