Revert API docs to RST since autodoc generates RST internally

The 12 API reference files under docs/api/ rely entirely on autodoc
directives, which generate RST output. Keeping these as .rst files
is simpler than wrapping every directive in {eval-rst} blocks within
Markdown files. Sphinx handles .rst and .md coexistence via the
source_suffix configuration.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: laughingman7743

docs/api/arrow.md docs/api/arrow.rstdocs/api/arrow.md renamed to docs/api/arrow.rst

@@ -1,49 +1,40 @@
-(api_arrow)=
+.. _api_arrow:
 
-# Apache Arrow Integration
+Apache Arrow Integration
+========================
 
 This section covers Apache Arrow-specific cursors, result sets, and data converters.
 
-## Arrow Cursors
+Arrow Cursors
+-------------
 
-```{eval-rst}
 .. autoclass:: pyathena.arrow.cursor.ArrowCursor
    :members:
    :inherited-members:
-```
 
-```{eval-rst}
 .. autoclass:: pyathena.arrow.async_cursor.AsyncArrowCursor
    :members:
    :inherited-members:
-```
 
-## Arrow Result Set
+Arrow Result Set
+----------------
 
-```{eval-rst}
 .. autoclass:: pyathena.arrow.result_set.AthenaArrowResultSet
    :members:
    :inherited-members:
-```
 
-## Arrow Data Converters
+Arrow Data Converters
+----------------------
 
-```{eval-rst}
 .. autoclass:: pyathena.arrow.converter.DefaultArrowTypeConverter
    :members:
-```
 
-```{eval-rst}
 .. autoclass:: pyathena.arrow.converter.DefaultArrowUnloadTypeConverter
    :members:
-```
 
-## Arrow Utilities
+Arrow Utilities
+---------------
 
-```{eval-rst}
 .. autofunction:: pyathena.arrow.util.to_column_info
-```
 
-```{eval-rst}
-.. autofunction:: pyathena.arrow.util.get_athena_type
-```
+.. autofunction:: pyathena.arrow.util.get_athena_type

docs/api/connection.md docs/api/connection.rstdocs/api/connection.md renamed to docs/api/connection.rst

@@ -1,65 +1,52 @@
-(api_connection)=
+.. _api_connection:
 
-# Connection and Cursors
+Connection and Cursors
+======================
 
 This section covers the core connection functionality and basic cursor operations.
 
-## Connection
+Connection
+----------
 
-```{eval-rst}
 .. automodule:: pyathena
    :members: connect
-```
 
-```{eval-rst}
 .. autoclass:: pyathena.connection.Connection
    :members:
    :inherited-members:
-```
 
-## Standard Cursors
+Standard Cursors
+----------------
 
-```{eval-rst}
 .. autoclass:: pyathena.cursor.Cursor
    :members:
    :inherited-members:
-```
 
-```{eval-rst}
 .. autoclass:: pyathena.cursor.DictCursor
    :members:
    :inherited-members:
-```
 
-## Asynchronous Cursors
+Asynchronous Cursors
+--------------------
 
-```{eval-rst}
 .. autoclass:: pyathena.async_cursor.AsyncCursor
    :members:
    :inherited-members:
-```
 
-```{eval-rst}
 .. autoclass:: pyathena.async_cursor.AsyncDictCursor
    :members:
    :inherited-members:
-```
 
-## Result Sets
+Result Sets
+-----------
 
-```{eval-rst}
 .. autoclass:: pyathena.result_set.AthenaResultSet
    :members:
    :inherited-members:
-```
 
-```{eval-rst}
 .. autoclass:: pyathena.result_set.AthenaDictResultSet
    :members:
    :inherited-members:
-```
 
-```{eval-rst}
 .. autoclass:: pyathena.result_set.WithResultSet
-   :members:
-```
+   :members:

docs/api/converters.md docs/api/converters.rstdocs/api/converters.md renamed to docs/api/converters.rst

@@ -1,29 +1,24 @@
-(api_converters)=
+.. _api_converters:
 
-# Data Conversion
+Data Conversion
+===============
 
 This section covers data type converters and parameter formatters.
 
-## Type Converters
+Type Converters
+---------------
 
-```{eval-rst}
 .. autoclass:: pyathena.converter.Converter
    :members:
-```
 
-```{eval-rst}
 .. autoclass:: pyathena.converter.DefaultTypeConverter
    :members:
-```
 
-## Parameter Formatters
+Parameter Formatters
+--------------------
 
-```{eval-rst}
 .. autoclass:: pyathena.formatter.Formatter
    :members:
-```
 
-```{eval-rst}
 .. autoclass:: pyathena.formatter.DefaultParameterFormatter
-   :members:
-```
+   :members:

docs/api/errors.md docs/api/errors.rstdocs/api/errors.md renamed to docs/api/errors.rst

@@ -1,71 +1,55 @@
-(api_errors)=
+.. _api_errors:
 
-# Exception Handling
+Exception Handling
+==================
 
 This section covers all PyAthena exception classes and error handling.
 
-## Exception Hierarchy
+Exception Hierarchy
+--------------------
 
-```{eval-rst}
 .. automodule:: pyathena.error
    :members:
    :show-inheritance:
-```
 
-## Base Exceptions
+Base Exceptions
+---------------
 
-```{eval-rst}
 .. autoclass:: pyathena.error.Error
    :members:
-```
 
-```{eval-rst}
 .. autoclass:: pyathena.error.Warning
    :members:
-```
 
-## Interface Errors
+Interface Errors
+-----------------
 
-```{eval-rst}
 .. autoclass:: pyathena.error.InterfaceError
    :members:
-```
 
-```{eval-rst}
 .. autoclass:: pyathena.error.DatabaseError
    :members:
-```
 
-## Data Errors
+Data Errors
+-----------
 
-```{eval-rst}
 .. autoclass:: pyathena.error.DataError
    :members:
-```
 
-```{eval-rst}
 .. autoclass:: pyathena.error.IntegrityError
    :members:
-```
 
-```{eval-rst}
 .. autoclass:: pyathena.error.InternalError
    :members:
-```
 
-## Operational Errors
+Operational Errors
+------------------
 
-```{eval-rst}
 .. autoclass:: pyathena.error.OperationalError
    :members:
-```
 
-```{eval-rst}
 .. autoclass:: pyathena.error.ProgrammingError
    :members:
-```
 
-```{eval-rst}
 .. autoclass:: pyathena.error.NotSupportedError
-   :members:
-```
+   :members:

docs/api/filesystem.md docs/api/filesystem.rstdocs/api/filesystem.md renamed to docs/api/filesystem.rst

@@ -1,56 +1,42 @@
-(api_filesystem)=
+.. _api_filesystem:
 
-# File System Integration
+File System Integration
+=======================
 
 This section covers S3 filesystem integration and object management.
 
-## S3 FileSystem
+S3 FileSystem
+-------------
 
-```{eval-rst}
 .. autoclass:: pyathena.filesystem.s3.S3FileSystem
    :members:
-```
 
-```{eval-rst}
 .. autoclass:: pyathena.filesystem.s3.S3File
    :members:
-```
 
-## S3 Objects
+S3 Objects
+----------
 
-```{eval-rst}
 .. autoclass:: pyathena.filesystem.s3_object.S3Object
    :members:
-```
 
-```{eval-rst}
 .. autoclass:: pyathena.filesystem.s3_object.S3ObjectType
    :members:
-```
 
-```{eval-rst}
 .. autoclass:: pyathena.filesystem.s3_object.S3StorageClass
    :members:
-```
 
-## S3 Upload Operations
+S3 Upload Operations
+--------------------
 
-```{eval-rst}
 .. autoclass:: pyathena.filesystem.s3_object.S3PutObject
    :members:
-```
 
-```{eval-rst}
 .. autoclass:: pyathena.filesystem.s3_object.S3MultipartUpload
    :members:
-```
 
-```{eval-rst}
 .. autoclass:: pyathena.filesystem.s3_object.S3MultipartUploadPart
    :members:
-```
 
-```{eval-rst}
 .. autoclass:: pyathena.filesystem.s3_object.S3CompleteMultipartUpload
-   :members:
-```
+   :members: