Skip to content

docs: Consolidate pages for access user management #168

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 4 commits into
base: main
Choose a base branch
from

Conversation

katmayb
Copy link
Contributor

@katmayb katmayb commented Aug 15, 2025

This PR consolidates some of the Admin dropdown content into different pages to declutter the nav and improve the general flow of the new LangSmith docs site.

This is according to this screenshot:

image

General light content edits to each of the pages included.

Note for reviewers: I've included the nav json for review (and to generate preview), however, will not merge that because we're hiding the LS in the Mintlify nav until we have the p0 content changes complete this/next week.

Also, in tandem with these content PRs, I'm updating a running PR with redirects (open in the old repo).

Preview

https://langchain-5e9cc07a-preview-consol-1755269390-3ff248a.mintlify.app/langsmith/set-up-a-workspace

(consolidated pages: set-up-a-workpace.mdx, billing.mdx, user-management.mdx)

@katmayb katmayb marked this pull request as ready for review August 15, 2025 14:54
@katmayb katmayb requested a review from lnhsingh as a code owner August 15, 2025 14:54

### Developer Plan: set up billing on your personal organization

Personal organizations are limited to 5000 traces per month until a credit card is added. You can add a credit card on the Plans and Billing page as follows:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should "Plans and Billing" be bolded or hyperlinked?


### Plus Plan: set up billing on a shared organization

If you have not yet created an organization, you need to follow [this guide](/langsmith/set-up-a-workspace#set-up-an-organization) before setting up billing. The following steps assume you are already in a new organization.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If you have not yet created an organization, you need to follow [this guide](/langsmith/set-up-a-workspace#set-up-an-organization) before setting up billing. The following steps assume you are already in a new organization.
If you haven't created an organization, [add one first](/langsmith/set-up-a-workspace#set-up-an-organization) before setting up billing. The following steps assume you are already in a new organization.

If you are a startup building with AI, instead click **Apply Now** on the Startup Plan. You may be eligible for discounted prices and a free, monthly trace allotment.
</Note>

![](/langsmith/images/new-org-billing-page.png)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not a blocker and not for this PR but we should add alt text at some point.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, we should! We have an issue open to tackle this post migration.


## Export a dataset

You can export your LangSmith dataset to a CSV, JSONL, or [OpenAI's fine tuning format](https://platform.openai.com/docs/guides/fine-tuning#example-format) from the LangSmith UI.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Today I learned JSON_L_ is a thing


#### Using the API

If you commit via the API, you can specify to skip triggering the webhook by setting the `skip_webhooks` parameter to `true` or to an array of webhook ids to ignore. Refer to the [API docs](https://api.smith.langchain.com/redoc#tag/commits/operation/create_commit_api_v1_commits__owner___repo__post) for more information.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If you commit via the API, you can specify to skip triggering the webhook by setting the `skip_webhooks` parameter to `true` or to an array of webhook ids to ignore. Refer to the [API docs](https://api.smith.langchain.com/redoc#tag/commits/operation/create_commit_api_v1_commits__owner___repo__post) for more information.
If you commit via the API, you can specify to skip triggering the webhook by setting the `skip_webhooks` parameter to `true` or to an array of webhook IDs to ignore. Refer to the [API docs](https://api.smith.langchain.com/redoc#tag/commits/operation/create_commit_api_v1_commits__owner___repo__post) for more information.

@beklapko
Copy link
Contributor

Looks good, just flagged some minor stuff! I may have made some suggestions that didn't make sense where I didn't have enough context so feel free to ignore those.

@katmayb
Copy link
Contributor Author

katmayb commented Aug 15, 2025

Awesome thanks @beklapko !

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants