doc: add documentation for new api

Refs: #794, #2311

Author: simschla

plugin-gradle/CHANGES.md

@@ -10,6 +10,7 @@ We adhere to the [keepachangelog](https://keepachangelog.com/en/1.0.0/) format (
 ### Fixed
 * You can now use `removeUnusedImports` and `googleJavaFormat` at the same time again. (fixes [#2159](https://github.com/diffplug/spotless/issues/2159))
 * The default list of type annotations used by `formatAnnotations` now includes Jakarta Validation's `Valid` and constraints validations (fixes [#2334](https://github.com/diffplug/spotless/issues/2334))
+* The API for generic indentation has been clarified. We deprecated `indentWithSpaces` and `indentWithTabs` in favor of `leadingTabsToSpaces` and `leadingSpacesToTabs`. ([#794](https://github.com/diffplug/spotless/issues/794), [#2350](https://github.com/diffplug/spotless/pull/2350))
 
 ## [7.0.0.BETA4] - 2024-10-24
 ### Added

plugin-gradle/README.md

@@ -109,7 +109,7 @@ spotless {
 
     // define the steps to apply to those files
     trimTrailingWhitespace()
-    indentWithTabs() // or spaces. Takes an integer argument if you don't like 4
+    leadingSpacesToTabs() // or leadingTabsToSpaces. Takes an integer argument if you don't like 4
     endWithNewline()
   }
   java {