docs: add comprehensive settings documentation

[KJ7LNW]

This PR adds detailed documentation for adding and managing settings in the application.

Context

This PR adds comprehensive documentation on how to add and manage settings in the application, including:

• Steps for adding all types of settings (checkbox, dropdown, enum)
• Type safety considerations
• Persistence chain details
• Debugging guidance for settings issues

Implementation

The documentation provides a complete guide for developers to understand the settings system and implement new settings correctly, ensuring proper type safety and persistence.

How to Test

Review the documentation for completeness and accuracy.

Fixes: #4129

---

Important

Adds comprehensive documentation for adding and managing settings, covering schema definitions, type safety, persistence, and debugging.

• Documentation:
  • Adds docs/settings.md with detailed steps for adding and managing settings, including schema definitions, type definitions, and test coverage.
  • Covers specific instructions for checkbox, dropdown, and enum settings.
  • Provides guidance on type safety, persistence chain, and debugging settings issues.
• Settings Management:
  • Instructions for adding settings to globalSettingsSchema and globalSettingsRecord in schemas/index.ts.
  • Details on adding settings to type definitions in exports/types.ts, exports/roo-code.d.ts, shared/ExtensionMessage.ts, and shared/WebviewMessage.ts.
  • Steps for UI integration in SettingsView.tsx and state management in ClineProvider.ts.
• Debugging and Testing:
  • Debugging strategies for settings persistence issues.
  • Emphasizes test coverage for new settings in ClineProvider.test.ts.

^{This description was created by for 0ece9e7. You can customize this summary. It will automatically update as commits are pushed.}

[ellipsis-dev]

The enum/compound data type instructions are duplicated (lines 174–250 and 252–349). Consider merging or removing one copy to avoid redundancy.

[daniel-lxs]

Hey @KJ7LNW, This seems slightly outdated, we recently moved types definitions to it's own package @roo-code/types.

You might have to rewrite some parts of the documentation, I'm not sure how stable the current structure is, so we can wait until things settle down.

[KJ7LNW]

Hey @KJ7LNW, This seems slightly outdated, we recently moved types definitions to it's own package @roo-code/types.

You might have to rewrite some parts of the documentation, I'm not sure how stable the current structure is, so we can wait until things settle down.

that sounds fine I am not in a hurry for this but I do not want to get lost either

[daniel-lxs]

Thank you for updating this, I think there are a couple of outdated instructions, although it makes sense considering how fast is Roo Code changing.

[daniel-lxs]

The import path here is incorrect. Based on the codebase:

// ❌ Incorrect
import { globalSettingsSchema, globalSettingsRecord } from "schemas/index.ts"

// ✅ Correct
import { globalSettingsSchema } from "@roo-code/types"

Also, globalSettingsRecord doesn't exist in the codebase - only globalSettingsSchema is available.

[daniel-lxs]

These files don't exist in the repository. The actual built type definitions are located at:

packages/types/dist/index.d.ts

Could you update this section to reference the correct location of the auto-generated types?

[daniel-lxs]

This test example doesn't exist in src/core/webview/__tests__/ClineProvider.test.ts. The file contains tests for various settings, but no test specifically for myCheckboxSetting.

Would it be helpful to either:

1. Add this test to demonstrate the pattern, or
2. Update the documentation to reference an existing test case?

[KJ7LNW]

I'll be adding a setting soon, so I'll validate these for a real use case and re-push 'em.

[KJ7LNW]

probably not going to get to this, closing.