docs: correct PlatformServiceMixin caching documentation and fix interface comments #166

Open
anomalist wants to merge 3 commits from platformservicemixin-interface-consolidation into master

3 Commits

Author SHA1 Message Date
Matthew Raymer
243c3eea32 feat(platform): complete $updateSettings deprecation and interface consolidation
- Remove deprecated $updateSettings method entirely
- Migrate 21 components to use proper settings methods
- Consolidate IPlatformServiceMixin and ComponentCustomProperties interfaces
- Establish single source of truth for platform service methods
- Update all components to use $saveMySettings, $saveUserSettings, $saveSettings
- Remove interface duplication and deprecated method warnings
- Ensure clean, maintainable codebase with proper separation of concerns

Breaking Change: $updateSettings method removed - use $saveSettings variants instead
2025-08-19 11:26:04 +00:00
Matthew Raymer
1d0c8ac3cf Merge branch 'master' into platformservicemixin-interface-consolidation 2025-08-19 10:46:58 +00:00
Matthew Raymer
18fc31d45a docs: correct PlatformServiceMixin caching documentation and fix interface comments
- Fix misleading claims about WeakMap-based caching (all caching code is commented out)
- Correct interface comment from "contacts cached, settings fresh" to "always fresh (no caching)"
- Add comprehensive clarification section explaining caching confusion
- Document that caching system was planned but never implemented
- Update performance optimizations section to reflect actual no-caching reality

The documentation now accurately reflects that this is a no-caching system
that provides convenience methods for database operations, not a
performance-optimized caching system as previously claimed.
2025-08-13 05:08:36 +00:00