addressing comments and reorg.

Signed-off-by: hayleycd <[email protected]>

content/en/language_clients/go/overview.md → content/en/language_clients/go.md

@@ -1,8 +1,8 @@
 ---
 type: docs
-category: Go
-title: Go Client Overview
-weight: 5
+category: Language Clients
+title: Go
+weight: 10
 ---
 
 [`sigstore-go`](https://pkg.go.dev/github.com/sigstore/sigstore-go) is the Go language client library for Sigstore.

content/en/language_clients/java/overview.md → content/en/language_clients/java.md

@@ -1,17 +1,17 @@
 ---
 type: docs
-category: Java
-title: Java Client Overview
-weight: 5
+category: Language Clients
+title: Java
+weight: 20
 ---
 
 [`sigstore-java`](https://github.com/sigstore/sigstore-java#sigstore-java) is a java client for interacting with the Sigstore infrastructure.
 
 ## Features
 
-- Includes both [Maven](https://github.com/sigstore/sigstore-java/tree/main/sigstore-maven-plugin) and [Gradle](https://github.com/sigstore/sigstore-java/tree/main/sigstore-gradle) build plugins
+- [Maven](https://github.com/sigstore/sigstore-java/tree/main/sigstore-maven-plugin) and [Gradle](https://github.com/sigstore/sigstore-java/tree/main/sigstore-gradle) signing plugins
 - Keyless signing and verifying
-- [API](https://javadoc.io/doc/dev.sigstore/sigstore-java)
+- Java native signing and verifying [API](https://javadoc.io/doc/dev.sigstore/sigstore-java)
 
 ## Installation
 
@@ -51,9 +51,9 @@ plugins {
 
 More information on the Gradle build plugin is available in the [project repository](https://github.com/sigstore/sigstore-java/tree/main/sigstore-gradle#sigstore-gradle).
 
-## Example
+## API Usage Examples
 
-### Signing example
+### Signing
 
 ```java
 Path testArtifact = Paths.get("path/to/my/file.jar")
@@ -66,7 +66,7 @@ Bundle result = signer.signFile(testArtifact);
 String bundleJson = result.toJson();
 ```
 
-### Verifying example
+### Verifying
 
 #### Get artifact and bundle
 
@@ -104,4 +104,4 @@ try {
 
 ### Additional examples
 
-[Additional](https://github.com/sigstore/sigstore-java/tree/main/examples/hello-world#sigstore-examples) [examples](https://github.com/sigstore/sigstore-java/tree/main/examples/pgp#pgp-test-keys-for-examples) are available in the project repository.
+[Additional](https://github.com/sigstore/sigstore-java/tree/main/examples/hello-world#sigstore-examples) [examples](https://github.com/sigstore/sigstore-java/tree/main/examples/pgp#pgp-test-keys-for-examples) are available in the project repository.

content/en/language_clients/javascript/overview.md → content/en/language_clients/javascript.md

@@ -1,8 +1,8 @@
 ---
 type: docs
-category: JavaScript
-title: JavaScript Client Overview
-weight: 5
+category: Language Clients
+title: JavaScript
+weight: 30
 ---
 
 [sigstore-js](https://github.com/sigstore/sigstore-js) is a collection of [javascript libraries](#additional-packages) for interacting with Sigstore.

content/en/language_clients/language_client_overview.md

@@ -7,13 +7,14 @@ weight: 5
 
 Sigstore uses [cosign](../../cosign/signing/overview) to sign and verify packages by default, but you can opt to use a language specific client instead.
 
-Sigstore has clients for the following language ecosystems:
+Language client summaries are available in the main Sigstore documentation, but complete documentation is hosted in the individual project repositories.
 
-- [Go](../go/overview)
-- [Java](../java/overview)
-- [JavaScript](../javascript/overview)
-- [Python](../python/overview)
-- [Rust](../rust/overview)
-- [Ruby](https://github.com/sigstore/sigstore-ruby#sigstore)
+| Language Client Summary                  | Project Repository                                             |
+| ---------------------------------------- | -------------------------------------------------------------- |
+| [Go](../go)                              | [sigstore-go](https://github.com/sigstore/sigstore-go)         |
+| [Java](../java)                          | [sigstore-java](https://github.com/sigstore/sigstore-java)     |
+| [Javascript](../javascript)              | [sigstore-js](https://github.com/sigstore/sigstore-js)         |
+| [Python](../python)                      | [sigstore-python](https://github.com/sigstore/sigstore-python) |
+| Ruby (available soon)                    | [sigstore-ruby](https://github.com/sigstore/sigstore-ruby)     |
+| [Rust](../rust)                          | [sigstore-rs](https://github.com/sigstore/sigstore-rs)         |
 
-Language client documentation is hosted in the individual project repositories. Project summaries are currently being added to the main Sigstore documentation.

content/en/language_clients/python/overview.md → content/en/language_clients/python.md

@@ -1,8 +1,8 @@
 ---
 type: docs
-category: Python
-title: Python Client Overview
-weight: 5
+category: Language Clients
+title: Python
+weight: 40
 ---
 
 [`sigstore`](https://pypi.org/project/sigstore/) is a Python tool for generating and verifying Sigstore signatures. You can use it to sign and verify Python package distributions, or anything else!

content/en/language_clients/rust/overview.md → content/en/language_clients/rust.md

@@ -1,8 +1,8 @@
 ---
 type: docs
-category: Rust
-title: Rust Client Overview
-weight: 5
+category: Language Clients
+title: Rust
+weight: 50
 ---
 
 [`sigstore`](https://crates.io/crates/sigstore) is a crate designed to interact with Sigstore architecture.