Java 17 + Fixed-Width Output Fields in CLI + Extra CSS for code snippets

Author: jaceklaskowski

docs/cli/index.md

@@ -17,6 +17,27 @@ Currently, auth using bearer token is supported. Please specify the token via --
 For detailed help on entity specific operations, use bin/uc <entity> --help
 ```
 
+## Fixed-Width Output Fields
+
+As of [this commit]({{ uc.commit }}/06ea446a3a00e78f82a77039dae22339152e2e1d), the tabular output of Unity Catalog CLI always displays the entire values of the following columns (case-insensitive):
+
+* `NAME`
+* Any column with `ID` suffix (e.g., `TABLE_ID`)
+
+``` { .console .no-copy }
+$ ./bin/uc table list --catalog unity --schema default
+┌─────────────────┬────────────┬────────────┬────────────┬────────────┬────────────┬────────────┬────────────┬────────────┬────────────┬────────────┬────────────────────────────────────┐
+│      NAME       │CATALOG_NAME│SCHEMA_NAME │ TABLE_TYPE │DATA_SOURCE_│  COLUMNS   │STORAGE_LOCA│  COMMENT   │ PROPERTIES │ CREATED_AT │ UPDATED_AT │              TABLE_ID              │
+│                 │            │            │            │   FORMAT   │            │    TION    │            │            │            │            │                                    │
+├─────────────────┼────────────┼────────────┼────────────┼────────────┼────────────┼────────────┼────────────┼────────────┼────────────┼────────────┼────────────────────────────────────┤
+│numbers          │unity       │default     │EXTERNAL    │DELTA       │[{"name":...│file:///U...│External ...│{"key1":"...│172042953...│172042953...│b5d6db68-5eca-485c-be5f-5f53d4f27f60│
+├─────────────────┼────────────┼────────────┼────────────┼────────────┼────────────┼────────────┼────────────┼────────────┼────────────┼────────────┼────────────────────────────────────┤
+│marksheet_uniform│unity       │default     │EXTERNAL    │DELTA       │[{"name":...│file:///t...│Uniform t...│{"key1":"...│172042953...│172042953...│76874c28-0ebf-46e7-9971-eb164bd62c46│
+├─────────────────┼────────────┼────────────┼────────────┼────────────┼────────────┼────────────┼────────────┼────────────┼────────────┼────────────┼────────────────────────────────────┤
+│marksheet        │unity       │default     │MANAGED     │DELTA       │[{"name":...│file:///U...│Managed t...│{"key1":"...│172042953...│172042953...│25ca07aa-1350-4104-b485-13b9ad1f5d72│
+└─────────────────┴────────────┴────────────┴────────────┴────────────┴────────────┴────────────┴────────────┴────────────┴────────────┴────────────┴────────────────────────────────────┘
+```
+
 ## Entities
 
 Unity Catalog CLI supports the following entities:

docs/features/index.md

@@ -18,13 +18,13 @@ The server and CLI can be started on command line using `bin/start-uc-server` an
 
 ## Running Unity Catalog
 
-Java 11 or above is required to run Unity Catalog.
+Java 17 or above is required to build and run Unity Catalog.
 
 ```text
 $ java --version
-openjdk 17.0.10 2024-01-16 LTS
-OpenJDK Runtime Environment Zulu17.48+15-CA (build 17.0.10+7-LTS)
-OpenJDK 64-Bit Server VM Zulu17.48+15-CA (build 17.0.10+7-LTS, mixed mode, sharing)
+openjdk 17.0.11 2024-04-16 LTS
+OpenJDK Runtime Environment Zulu17.50+19-CA (build 17.0.11+9-LTS)
+OpenJDK 64-Bit Server VM Zulu17.50+19-CA (build 17.0.11+9-LTS, mixed mode, sharing)
 ```
 
 ```text

docs/stylesheets/extra.css

@@ -0,0 +1,3 @@
+:root {
+    --md-code-font: "Monaco Regular";
+}

mkdocs.yml

@@ -46,6 +46,10 @@ theme:
         icon: material/toggle-switch
         name: Switch to light mode
 
+# https://squidfunk.github.io/mkdocs-material/customization/#additional-css
+extra_css:
+  - stylesheets/extra.css
+
 markdown_extensions:
   - admonition
   - attr_list
@@ -62,10 +66,15 @@ markdown_extensions:
   - pymdownx.emoji:
       emoji_index: !!python/name:material.extensions.emoji.twemoji
       emoji_generator: !!python/name:material.extensions.emoji.to_svg
+  - pymdownx.highlight:
+      anchor_linenums: true
+      line_spans: __span
+      pygments_lang_class: true
   - pymdownx.inlinehilite
   - pymdownx.magiclink
   - pymdownx.mark
   - pymdownx.smartsymbols
+  - pymdownx.snippets
   - pymdownx.superfences
   - pymdownx.tasklist:
       custom_checkbox: true
@@ -92,6 +101,7 @@ extra:
     title: Unity Catalog
   uc:
     version: 0.1.0
+    commit: https://github.com/unitycatalog/unitycatalog/commit
     github: https://github.com/unitycatalog/unitycatalog/blob/main
   armeria:
     version: 1.28.4