addressing comments and reorg.

Signed-off-by: hayleycd <cook.hayley@gmail.com>

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 @@
 
 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 @@
 String bundleJson = result.toJson();
 ```
 
-### Verifying example
+### Verifying
 
 #### Get artifact and bundle
 
@@ -104,4 +104,4 @@
 
 ### 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/language_client_overview.md

@@ -9,11 +9,12 @@
 
 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.