DOC: Feedback: Please consistently document sdk functions, at least exhaustive docstrings

[ldorigo]

Issue with current documentation:

Everyone in our team agrees that Langsmith is a great product, but the documentation is pretty bad. Information is scattered in many different places and it takes extremely long to figure out how to do the most basic things.

Adding consistent, detailed, useful docstrings to all sdk functions would be a great start to improving this.

Example that triggered this issue: the trace context manager doesn't have any docstring. Some parameters are obvious but others are not: what does exceptions_to_handle do? what does reference_example_id do? What are the possible values for parent that correspond to the various different type annotations? What is extra?

Idea or request for content:

No response