docs: use computed property value in docs #12358
Open
+8
−8
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?
Refactor storage adapter collections config in the examples to use computed property values via .slug rather than raw string literals.
Why?
Using computed values (e.g., [Media.slug]) ensures the adapter key stays in sync with the actual collection slug, avoiding silent mismatches due to typos or future refactors. While such mismatches shouldn’t happen in a well-managed codebase, “Anything that can happen will happen.” – Murphy’s Law.
This approach improves reliability and clarity. The original example mixed media (default collection key) with a literal string 'media-with-prefix', which could be confusing—especially since these examples are in documentation and readers cannot inspect the underlying collections directly to understand these are representing their respective slugs.
How?
Replaced hard-coded keys in the collections config with computed property values:
This ensures both configuration keys are explicitly tied to their respective collections.