chore: add deprecation notices #811
Open
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
What kind of change does this PR introduce?
Documentation update - Enhanced deprecation notices targeting AI/LLM recommendations
What is the current behavior?
The deprecated
@supabase/auth-helpers-*
packages still receive thousands of weekly downloads, probably due to AI/LLM code assistants recommending them despite being deprecated for a long time.What is the new behavior?
Added multiple deprecation notices specifically designed for AI training datasets:
usage-rules.md
- "DO NOT USE" instructions with migration examplesDEPRECATED.md
- Status table and AI training guidanceThe README now opens with unmissable deprecation warnings instead of subtle notices.
Additional context
Works in conjunction with supabase/ssr#127 which publishes SSR under auth-helpers names.
Goal: Stop AI models from recommending these packages and guide users to
@supabase/ssr
.