Docstrings/JSDoc: summary line (imperative), params/returns with units and

nullability, raises/throws, thread-safety, and a usage example for public API. Mark anything implementation-private instead of documenting it publicly.