Improve documentation for format OPTIONS clause (#15708)

* doc:Add documentation for OPTIONS clause syntax

* doc:rename write_options.md to format_options.md and clarify its scope for both reading and writing

* doc: change dml.md, cuz still have wrong write_options filename

* doc: update doctest reference to renamed format_options.md

* docs: update and correct format options documentation

* doc: add more information of options content

* remove execution settings, move note about insert

* wordsmith example

---------

Co-authored-by: Andrew Lamb <[email protected]>

Author: marvelshan

datafusion/core/src/lib.rs

@@ -1027,8 +1027,8 @@ doc_comment::doctest!(
 
 #[cfg(doctest)]
 doc_comment::doctest!(
-    "../../../docs/source/user-guide/sql/write_options.md",
-    user_guide_sql_write_options
+    "../../../docs/source/user-guide/sql/format_options.md",
+    user_guide_sql_format_options
 );
 
 #[cfg(doctest)]

docs/source/user-guide/sql/ddl.md

@@ -74,7 +74,7 @@ LOCATION <literal>
 <key_value_list> := (<literal> <literal, <literal> <literal>, ...)
 ```
 
-For a detailed list of write related options which can be passed in the OPTIONS key_value_list, see [Write Options](write_options).
+For a comprehensive list of format-specific options that can be specified in the `OPTIONS` clause, see [Format Options](format_options.md).
 
 `file_type` is one of `CSV`, `ARROW`, `PARQUET`, `AVRO` or `JSON`
 

docs/source/user-guide/sql/dml.md

@@ -49,7 +49,7 @@ The output format is determined by the first match of the following rules:
 1. Value of `STORED AS`
 2. Filename extension (e.g. `foo.parquet` implies `PARQUET` format)
 
-For a detailed list of valid OPTIONS, see [Write Options](write_options).
+For a detailed list of valid OPTIONS, see [Format Options](format_options.md).
 
 ### Examples