docs(ingest): add path spec examples for s3

metadata-ingestion/docs/sources/s3/s3.md

@@ -1,5 +1,102 @@
 
-### Path Spec
+### Path Specs
+
+**Example - Dataset per file**
+
+Bucket structure:
+
+```
+test-s3-bucket
+├── employees.csv
+└── food_items.csv
+```
+
+Path specs config
+```
+path_specs:
+    - include: s3://test-s3-bucket/*.csv
+
+```
+
+**Example - Datasets with partitions**
+
+Bucket structure:
+```
+test-s3-bucket
+├── orders
+│   └── year=2022
+│       └── month=2
+│           ├── 1.parquet
+│           └── 2.parquet
+└── returns
+    └── year=2021
+        └── month=2
+            └── 1.parquet
+
+```
+
+Path specs config:
+```
+path_specs:
+    - include: s3://test-s3-bucket/{table}/{partition_key[0]}={partition[0]}/{partition_key[1]}={partition[1]}/*.parquet
+```
+
+**Example - Datasets with partition and exclude**
+
+Bucket structure:
+```
+test-s3-bucket
+├── orders
+│   └── year=2022
+│       └── month=2
+│           ├── 1.parquet
+│           └── 2.parquet
+└── tmp_orders
+    └── year=2021
+        └── month=2
+            └── 1.parquet
+
+
+```
+
+Path specs config:
+```
+path_specs:
+    - include: s3://test-s3-bucket/{table}/{partition_key[0]}={partition[0]}/{partition_key[1]}={partition[1]}/*.parquet
+      exclude: 
+        - **/tmp_orders/**
+```
+**Example - Datasets of mixed nature**
+
+Bucket structure:
+```
+test-s3-bucket
+├── customers
+│   ├── part1.json
+│   ├── part2.json
+│   ├── part3.json
+│   └── part4.json
+├── employees.csv
+├── food_items.csv
+├── tmp_10101000.csv
+└──  orders
+    └── year=2022
+        └── month=2
+            ├── 1.parquet
+            ├── 2.parquet
+            └── 3.parquet
+
+```
+
+Path specs config:
+```
+path_specs:
+    - include: s3://test-s3-bucket/*.csv
+      exclude:
+        - **/tmp_10101000.csv
+    - include: s3://test-s3-bucket/{table}/*.json
+    - include: s3://test-s3-bucket/{table}/{partition_key[0]}={partition[0]}/{partition_key[1]}={partition[1]}/*.parquet
+```
 
 **Valid path_specs.include**