Skip to content

docs(config): replace deprecated IConfig app/user value examples#14964

Open
skjnldsv wants to merge 1 commit into
masterfrom
fix/appconfig-iconfig-deprecated-docs
Open

docs(config): replace deprecated IConfig app/user value examples#14964
skjnldsv wants to merge 1 commit into
masterfrom
fix/appconfig-iconfig-deprecated-docs

Conversation

@skjnldsv
Copy link
Copy Markdown
Member

☑️ Resolves

Summary

basics/storage/configuration.rst showed IConfig::getAppValue/setAppValue and
IConfig::getUserValue/setUserValue as the recommended approach. Both are deprecated.

Changes:

  • App values section: replaced with OCP\AppFramework\Services\IAppConfig (deprecated since NC29). Added typed getter/setter example and cross-ref to the full appconfig.rst reference.
  • User values section: replaced with \OCP\Config\IUserConfig (deprecated since NC31). Added typed getter/setter example and cross-ref to the full userconfig.rst reference.
  • System values section: unchanged — IConfig is still the correct interface there.
  • Dropped the outdated manual service registration boilerplate from the intro.

Needs backports to stable30 and stable29 per maintainer comment on the issue.

🖼️ Screenshots

✅ Checklist

  • I have built the documentation locally and reviewed the output
  • Screenshots are included for visual changes
  • I have not moved or renamed pages (or added a redirect if I did)
  • I have run codespell or similar and addressed any spelling issues

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 20, 2026

📖 Documentation Preview

🔍 Open preview →

📄 1 changed documentation page

Last updated: Wed, 27 May 2026 09:03:07 GMT

Comment thread developer_manual/basics/storage/configuration.rst
Comment thread developer_manual/basics/storage/configuration.rst
Comment thread developer_manual/basics/storage/configuration.rst
Comment thread developer_manual/basics/storage/configuration.rst
@skjnldsv skjnldsv self-assigned this May 21, 2026
Copy link
Copy Markdown
Contributor

@come-nc come-nc left a comment

Choose a reason for hiding this comment

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

I agree with Kate about the code example, the IConfig one needs to be changed to be more like the IAppConfig one.

Comment thread developer_manual/basics/storage/configuration.rst
Comment thread developer_manual/basics/storage/configuration.rst
@come-nc
Copy link
Copy Markdown
Contributor

come-nc commented May 26, 2026

Also, Lexicon should be mentioned in there.
It could even be moved to this page instead of hidden in digging deeper.

- Rewrite system values code example with meaningful typed methods
  (getSystemValueString, getSystemValueInt, getSystemValueBool)
  instead of generic untyped getSystemValue/setSystemValue
- Integrate typed method guidance into prose, remove separate note block
- Rename "User values" section to "User settings"
- Add Lexicon cross-reference to the configuration overview
- Fix broken doc cross-references in storage/configuration

Signed-off-by: skjnldsv <skjnldsv@protonmail.com>
@skjnldsv skjnldsv force-pushed the fix/appconfig-iconfig-deprecated-docs branch from 606790f to 183f1fb Compare May 27, 2026 08:56
@skjnldsv skjnldsv requested review from come-nc and provokateurin May 27, 2026 08:57
@skjnldsv
Copy link
Copy Markdown
Member Author

Done @come-nc @provokateurin

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

AppConfig is not recommended everywhere

3 participants