A Community Feedback

Yesterday, while integrating the <UserButton /> component from clerk/nextjs in NextJS, I noticed a commonly used parameter afterSignOutUrl was marked as deprecated,

Looking at the implementation, it had been moved to <ClerkProvider />, so I decided to check the version history to understand the reasoning behind the change, only to find the official documentation hadn’t been updated.

I browsed the Clerk project repo and found the Discord channel is fairly active, so I reported the issue there and moved on.

To my surprise, I got a reply very quickly.

For fast-iterating open-source projects like Clerk, keeping documentation up to date seems to be a real challenge. This isn’t the first time I’ve encountered a mismatch between implementation and docs. In the past, the usual path was for a developer to open an issue or submit a PR following the project’s contribution guidelines. This time, being able to report directly to the maintainers in the Discord channel without having to study the commit conventions was quite convenient.