Some code review feedback

crates/ruff/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "ruff"
-version = "0.2.0"
+version = "0.2.1"
 publish = false
 authors = { workspace = true }
 edition = { workspace = true }

crates/ruff/src/args.rs

@@ -447,18 +447,17 @@ pub struct FormatCommand {
     #[clap(long, overrides_with("preview"), hide = true)]
     no_preview: bool,
 
-    /// Format code in the given <RANGE>.
+    /// Formats code in the specified range. When specified, Ruff will try to only format the code in the given range but
+    /// it might be necessary to extend the start backwards or the end forwards, e.g. to the start or end of the logical line.
     ///
-    /// The <RANGE> uses the format `<start_line>:<start_column>-<end_line><end_column>`.
+    /// The `<RANGE>` uses the format `<start_line>:<start_column>-<end_line><end_column>`.
+    /// The column numbers are the unicode codepoint from the beginning of the line.
     ///
+    /// * The line and column numbers are 1 based.
     /// * The end position is exclusive.
-    /// * The line and column numbers start at 1.
-    /// * The column numbers are optional, so you can write `--range=1-2` instead of `--range=1:1-2:1`
-    /// * The end position is optional, so you can write `--range=2` to format the entire document starting from the second line.
-    /// * The start position is optional, so you can write `--range=-3` to format the first three lines of the document.
-    ///
-    /// When specified, Ruff will try to only format the code in the given range but
-    /// it might be necessary to extend the start backwards or the end forwards, e.g. to the start or end of the logical line.
+    /// * The column numbers are optional. You can write `--range=1-2` instead of `--range=1:1-2:1`
+    /// * The end position is optional. You can write `--range=2` to format the entire document starting from the second line.
+    /// * The start position is optional. You can write `--range=-3` to format the first three lines of the document.
     ///
     /// The option can only be used when formatting a single file. Range formatting of notebooks is unsupported.
     #[arg(long)]

docs/configuration.md

@@ -654,7 +654,10 @@ Options:
           Enable preview mode; enables unstable formatting. Use `--no-preview`
           to disable
       --range <RANGE>
-          Format code in the given <RANGE>
+          Formats code in the specified range. When specified, Ruff will try to
+          only format the code in the given range but it might be necessary to
+          extend the start backwards or the end forwards, e.g. to the start or
+          end of the logical line
   -h, --help
           Print help (see more with '--help')