Update the FileSource and FileSink docs (#612)

Author: daniil-quix

docs/connectors/sinks/file-sink.md

@@ -9,12 +9,13 @@
 This sink writes batches of data to files on disk in various formats.  
 By default, the data will include the kafka message key, value, and timestamp.  
 
-Currently supports the following formats:
+Currently, it supports the following formats:
 
 - JSON
 - Parquet
 
 ## How the File Sink Works
+
 `FileSink` is a batching sink.  
 
 It batches processed records in memory per topic partition and writes them to files in a specified directory structure. Files are organized by topic and partition, with each batch being written to a separate file named by its starting offset.

docs/connectors/sources/file-source.md

@@ -1,13 +1,19 @@
-# Quix File Source Connector
+# File Source
+
+!!! info
+
+    This is a **Community** connector. Test it before using in production.
+
+    To learn more about differences between Core and Community connectors, see the [Community and Core Connectors](../community-and-core.md) page.
 
 This source enables reading from a localized file source, such as a JSONlines or Parquet
 file. It also supports file (de)compression.
 
 The resulting messages can be produced in "replay" mode, where the time between record 
 producing is matched as close as possible to the original. (per topic partition only).
 
-The Quix File Source Connector is generally intended to be used alongside the related 
-Quix File Sink Connector (in terms of expected file and data formatting).
+The File Source connector is generally intended to be used alongside the related 
+[File Sink](../sinks/file-sink.md) (in terms of expected file and data formatting).
 
 ## How to use CSV Source
 
@@ -17,6 +23,8 @@ and pass it to the `app.dataframe()` method.
 One important thing to note is that you should in general point to a single topic folder
 (rather than a root folder with many topics) otherwise topic partitions may not line up correctly.
 
+For the full description of expected parameters, see the [File Source API](../../api-reference/sources.md#filesource) page.  
+
 ```python
 from quixstreams import Application
 from quixstreams.sources.community.file import FileSource
@@ -36,7 +44,7 @@ if __name__ == "__main__":
 
 ## File hierarchy/structure
 
-The Quix File Source Connector expects a folder structure like so:
+The File Source expects a folder structure like so:
 
 ```
     my_sinked_topics/
@@ -51,13 +59,13 @@ The Quix File Source Connector expects a folder structure like so:
         └── etc...
 ```
 
-This is the default structure generated by the Quix File Sink Connector.
+This is the default structure generated by the File Sink.
 
 ## File data format/schema
 
 The expected data schema is largely dependent on the file format chosen.
 
-For easiest use with the Quix File Sink Connector, you can follow these patterns: 
+For easiest use with the [File Sink](../sinks/file-sink.md), you can follow these patterns: 
 
 - for row-based formats (like JSON), the expected data should have records
 with the following fields, where value is the entirety of the message value, 

mkdocs.yml

@@ -50,17 +50,17 @@ nav:
     -  Sinks:
         - 'connectors/sinks/README.md'
         - Apache Iceberg Sink: connectors/sinks/apache-iceberg-sink.md
-        - File Sink: connectors/sinks/file-sink.md
         - CSV Sink: connectors/sinks/csv-sink.md
         - InfluxDB v3 Sink: connectors/sinks/influxdb3-sink.md
+        - File Sink: connectors/sinks/file-sink.md
         - Creating a Custom Sink: connectors/sinks/custom-sinks.md
     - Sources:
         - 'connectors/sources/README.md'
         - CSV Source: connectors/sources/csv-source.md
+        - File Source: connectors/source/file-source.md
         - Kafka Replicator Source: connectors/sources/kafka-source.md
         - Quix Source: connectors/sources/quix-source.md
         - Creating a Custom Source: connectors/sources/custom-sources.md
-        - Local File Source: connectors/source/file-source.md
     - Contribution Guide: 'connectors/contribution-guide.md'
     - Community and Core Connectors: 'connectors/community-and-core.md'
   - Upgrading Guide:

quixstreams/sources/community/file/file.py

@@ -19,8 +19,7 @@ class FileSource(Source):
     Ingest a set of local files into kafka by iterating through the provided folder and
     processing all nested files within it.
 
-    Expects folder and file structures as generated by the related Quix Streams File
-    Sink Connector:
+    Expects folder and file structures as generated by the related FileSink connector:
 
     my_topics/
     ├── topic_a/