DOC-10413: Document REST endpoint to change LSS segment size (#200)

* Add LSS Segment File Size
* Minor Vale updates
* Update links
* Update units
* Build output documentation

---------

Co-authored-by: tech-comm-team-couchbase <tech-comm-team@couchbase.com>

Author: simon-dew

docs/modules/index-rest-settings/attachments/_index-settings.yaml

@@ -90,6 +90,23 @@ components:
     Settings:
       type: object
       properties:
+        indexer.plasma.LSSSegmentFileSize:
+          x-alt-title: indexer.​plasma.​LSSSegmentFileSize
+          type: integer
+          format: int32
+          x-has-example: true
+          example: 67108864
+          description: |-
+            For standard indexes using Plasma, the maximum size for Log Structured Store segment files, in bytes.
+            Index compaction and space reclamation are triggered when the segment file size reaches this value.
+
+            The default value is 512 MiB on Microsoft Windows and 4 GiB on GNU Linux and macOS.
+            Specifying a lower value (for example, 64 MiB) may trigger index compaction more frequently in cases where an index uses a lot of disk space, or index fragmentation is high.
+
+            This setting only applies to indexes created after the setting is changed.
+            For existing indexes, you must rebuild the index after changing the setting.
+
+            For more information, see [Standard Index Storage](/server/8.0/indexes/storage-modes.html#standard-index-storage).
         indexer.rebalance.transferBatchSize:
           x-alt-title: indexer.​rebalance.​transferBatchSize
           type: integer
@@ -279,7 +296,7 @@ components:
           description: |-
             Whether Bloom filters are enabled for memory management.
 
-            For details, see [Per Page Bloom Filters](/server/8.0/learn/services-and-indexes/indexes/storage-modes.html#per-page-bloom-filters).
+            For more information, see [Per Page Bloom Filters](/server/8.0/indexes/storage-modes.html#per-page-bloom-filters).
         indexer.settings.enable_shard_affinity:
           x-alt-title: indexer.​settings.​enable_shard_affinity
           type: boolean
@@ -575,7 +592,7 @@ components:
 
             * When false (the default), such redistribution does not occur.
 
-            For details, see [Rebalance](/server/8.0/learn/clusters-and-availability/rebalance.html#rebalancing-the-index-service).
+            For more information, see [Rebalance](/server/8.0/learn/clusters-and-availability/rebalance.html#rebalancing-the-index-service).
         indexer.settings.recovery.max_rollbacks:
           x-alt-title: indexer.​settings.​recovery.​max_rollbacks
           type: integer

docs/modules/index-rest-settings/pages/index.adoc

@@ -557,6 +557,30 @@ endif::collapse-models[]
 |===
 ¦ Property ¦ ¦ Schema
 
+a¦ 
+*indexer.​plasma.​LSSSegmentFileSize* +
+_optional_
+a¦ 
+
+[markdown]
+--
+For standard indexes using Plasma, the maximum size for Log Structured Store segment files, in bytes.
+Index compaction and space reclamation are triggered when the segment file size reaches this value.
+
+The default value is 512 MiB on Microsoft Windows and 4 GiB on GNU Linux and macOS.
+Specifying a lower value (for example, 64 MiB) may trigger index compaction more frequently in cases where an index uses a lot of disk space, or index fragmentation is high.
+
+This setting only applies to indexes created after the setting is changed.
+For existing indexes, you must rebuild the index after changing the setting.
+
+For more information, see [Standard Index Storage](/server/8.0/indexes/storage-modes.html#standard-index-storage).
+--
+
+[%hardbreaks]
+*Example:* `67108864`
+{blank}
+a¦ Integer (int32)
+
 a¦ 
 *indexer.​rebalance.​transferBatchSize* +
 _optional_
@@ -915,7 +939,7 @@ a¦
 --
 Whether Bloom filters are enabled for memory management.
 
-For details, see [Per Page Bloom Filters](/server/8.0/learn/services-and-indexes/indexes/storage-modes.html#per-page-bloom-filters).
+For more information, see [Per Page Bloom Filters](/server/8.0/indexes/storage-modes.html#per-page-bloom-filters).
 --
 
 [%hardbreaks]
@@ -1487,7 +1511,7 @@ Whether to redistribute indexes on rebalance.
 
 * When false (the default), such redistribution does not occur.
 
-For details, see [Rebalance](/server/8.0/learn/clusters-and-availability/rebalance.html#rebalancing-the-index-service).
+For more information, see [Rebalance](/server/8.0/learn/clusters-and-availability/rebalance.html#rebalancing-the-index-service).
 --
 
 [%hardbreaks]