Always verify that configuration file options and command flags are correct and properly documented. Incorrect configuration syntax can cause silent failures or unintended side effects that are difficult to debug.

Common issues include:

Before committing configuration changes:

  1. Check official documentation for correct option names and syntax
  2. Use specific flags to limit scope of operations (e.g., poetry lock --no-update instead of poetry lock)
  3. Test configuration changes to ensure they work as expected

Example from the discussions:

# Wrong - silently breaks functionality
[flake8]
enable-select = TC, TC1

# Correct - properly documented option
[flake8] 
extend-select = TC, TC1
# Wrong - updates all dependencies unintentionally
poetry lock

# Correct - only regenerates lock without updating versions
poetry lock --no-update