docs: Document by_id.

Fixes missing docs for by_id.

Fixes #922