chore: docs update after copybara

Author: gregmagolan

docs/aspect.md

@@ -24,7 +24,7 @@ Aspect CLI is a better frontend for running bazel
 * [aspect build](aspect_build.md)	 - Build the specified targets
 * [aspect canonicalize-flags](aspect_canonicalize-flags.md)	 - Present a list of bazel options in a canonical form
 * [aspect clean](aspect_clean.md)	 - Remove the output tree
-* [aspect configure](aspect_configure.md)	 - Update BUILD files for JavaScript, TypeScript, Go and Protobuf
+* [aspect configure](aspect_configure.md)	 - Auto-configure Bazel by updating BUILD files
 * [aspect coverage](aspect_coverage.md)	 - Same as 'test', but also generates a code coverage report.
 * [aspect cquery](aspect_cquery.md)	 - Query the dependency graph, honoring configuration flags
 * [aspect docs](aspect_docs.md)	 - Open documentation in the browser

docs/aspect_configure.md

@@ -3,11 +3,28 @@ sidebar_label: "configure"
 ---
 ## aspect configure
 
-Update BUILD files for JavaScript, TypeScript, Go and Protobuf
+Auto-configure Bazel by updating BUILD files
 
 ### Synopsis
 
-Generates and updates BUILD files from sources for JavaScript, TypeScript, Go and Protobuf.
+configure generates and updates BUILD files from source code.
+
+It is named after the "make configure" workflow which is typical in C++ projects, using
+[autoconf](https://www.gnu.org/software/autoconf/).
+
+configure is non-destructive: hand-edits to BUILD files are generally preserved.
+You can use a `#keep` directive to force the tool to leave existing BUILD contents alone.
+Run 'aspect help directives' for more documentation on directives.
+
+So far these languages are supported:
+- Go and Protocol Buffers, thanks to code from [gazelle]
+- JavaScript (including TypeScript)
+
+configure is based on [gazelle]. We are very grateful to the authors of that software.
+The advantage of configure in Aspect CLI is that you don't need to compile the tooling before running it.
+
+[gazelle]: https://github.com/bazelbuild/bazel-gazelle
+
 
 ```
 aspect configure [flags]