documenting API additions