Remove outdated unsupported YAML documentation comments

[jviotti]

Signed-off-by: Juan Cruz Viotti jv@jviotti.com

[cubic-dev-ai]

1 issue found across 2 files

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="docs/lint.markdown">

<violation number="1" location="docs/lint.markdown:42">
P2: `--format/-m` still rejects invocations without `--fix/-f`, so this paragraph implies formatting works standalone. Restore the prerequisite before describing its formatting behavior.</violation>
</file>

<sub>Reply with feedback, questions, or to request a fix.

Re-trigger cubic</sub>

[cubic-dev-ai]

P2: --format/-m still rejects invocations without --fix/-f, so this paragraph implies formatting works standalone. Restore the prerequisite before describing its formatting behavior.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At docs/lint.markdown, line 42:

<comment>`--format/-m` still rejects invocations without `--fix/-f`, so this paragraph implies formatting works standalone. Restore the prerequisite before describing its formatting behavior.</comment>

<file context>
@@ -39,13 +39,10 @@ automatically fix many of them.
-written with proper formatting (equivalent to running `fmt`), even if there
-are no lint issues to fix. Use `--keep-ordering/-k` with `--format/-m` to
-preserve key ordering during formatting.
+When `--format/-m` is set, the output file is always written with proper
+formatting (equivalent to running `fmt`), even if there are no lint issues to
+fix. Use `--keep-ordering/-k` with `--format/-m` to preserve key ordering
</file context>

Suggested change

	When `--format/-m` is set, the output file is always written with proper
	formatting (equivalent to running `fmt`), even if there are no lint issues to
	fix. Use `--keep-ordering/-k` with `--format/-m` to preserve key ordering
	during formatting.
	The `--format/-m` option requires `--fix/-f`; when set, the output file is always written with proper
	formatting (equivalent to running `fmt`), even if there are no lint issues to
	fix. Use `--keep-ordering/-k` with `--format/-m` to preserve key ordering
	during formatting.