Minor Changes

Author: rcosta358

examples.md

@@ -7,13 +7,4 @@ description: LiquidJava example usages with focused code snippets.
 
 # Examples
 
-Start with the full examples repository when you want a runnable setup, then use the snippets below as a map to the kinds of specifications you will find there.
-
-To try out the examples, you can:
-
-- Clone locally: `git clone {{ site.liquidjava_examples_url }}`
-- Open in the cloud: [GitHub Codespaces]({{ site.liquidjava_examples_codespaces_url }})
-
-Once the project is open, use the [VS Code extension]({{ site.liquidjava_vscode_extension_url }}) to run automatically run the verifier and view diagnostics directly in the editor.
-
-TODO: Add examples
+TODO

reference/ghosts.md

@@ -28,7 +28,7 @@ public interface StackRefinements<E> {
     @StateRefinement(from="size() > 0")
     public E peek();
 }
-````
+```
 
 ```java
 Stack<String> s = new Stack<>();

reference/state-refinements.md

@@ -59,7 +59,7 @@ If no `to` transition is written, LiquidJava defaults the constructor to the fir
 
 Constructors must always be present for typestate checking to work correctly, because they are the point where the initial state values are assigned. Otherwise, the initial values are not set and the verifier won't be able to track the state of the object across method calls, which can lead to unexpected type errors.
 
-When refining interfaces, there is no real constructor, but LiquidJava still needs an initialization point. In those cases, if the type is named `Interface`, it must declare a method with the signature `public void Interface()` so the initial values are set correctly. This method plays the role of a constructor for the typestate system.
+When refining interfaces, which cannot have a constructor, LiquidJava still needs an initialization point. In those cases, the refinement interface must declare a method whose name matches the class we are refining. For example, an interface named `ArrayListRefinements` that is refining `java.util.ArrayList` should declare the method `public void ArrayList()`. This method plays the role of a constructor for the typestate system and ensures the initial values are set correctly.
 
 
 ## Multiple StateSets

tooling/cli.md

@@ -4,42 +4,8 @@ nav_order: 5
 description: Run the LiquidJava verifier from the command line for local checks, debugging, and CI workflows.
 ---
 
-# Command Line
+# Command-Line Interface
 
-LiquidJava ships with a command-line entry point for verifying Java files or projects outside the editor flow.
-
-## Build the Project
-
-```bash
-git clone {{ site.liquidjava_repo_url }}
-cd liquidjava
-./mvnw clean install
-```
-
-## Run the Wrapper Script
-
-The repository includes a helper script named `liquidjava`:
-
-```bash
-./liquidjava /path/to/your/project
-```
-
-Internally it runs:
-
-```bash
-mvn exec:java -pl liquidjava-verifier \
-  -Dexec.mainClass="liquidjava.api.CommandLineLauncher" \
-  -Dexec.args="/path/to/your/project"
-```
-
-## Example Outcomes
-
-- A correct file should pass verification.
-- A file that violates a refinement should produce an error that points to the failed contract.
-
-## When to Use the CLI
-
-- CI or scripted checks
-- quick local experiments
-- environments where you do not want to rely on VS Code
-- debugging verifier behavior separately from editor integration
+TODO:
+- Flags and options
+- Example usage

tooling/vscode-extension.md

@@ -6,39 +6,11 @@ description: Install the LiquidJava VS Code extension for live verification, syn
 
 # VS Code Extension
 
-The VS Code extension is the smoothest way to work with LiquidJava day to day.
-
-## What It Adds
-
-- real-time verification diagnostics
-- syntax highlighting for refinement annotations
-- richer diagnostic details in a webview
-- state-machine visualizations for protocol-oriented specifications
-
-## Install
-
-- Install [LiquidJava on the VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=AlcidesFonseca.liquid-java) or [Open VSX](https://open-vsx.org/extension/AlcidesFonseca/liquid-java).
-- Install [Language Support for Java by Red Hat](https://marketplace.visualstudio.com/items?itemName=redhat.java).
-- Open a Java project that includes the `liquidjava-api` dependency.
-
-## Example Dependency
-
-```xml
-<dependency>
-    <groupId>io.github.liquid-java</groupId>
-    <artifactId>liquidjava-api</artifactId>
-    <version>{{ site.liquidjava_api_version }}</version>
-</dependency>
-```
-
-## Best Way to Try It
-
-The [examples repository]({{ site.liquidjava_examples_url }}) is set up for experimentation and can be opened directly in [GitHub Codespaces]({{ site.liquidjava_examples_codespaces_url }}).
-
-## Source
-
-- [Extension source repository](https://github.com/liquid-java/vscode-liquidjava)
-- [Main LiquidJava repository]({{ site.liquidjava_repo_url }})
-
-{: .tip }
-If you want to understand the annotation language before installing tooling, start with [Refinements]({{ '/reference/refinements/' | relative_url }}).
+TODO:
+- Real-time verification diagnostics
+- Syntax highlighting for refinements
+- Autocomplete for refinements
+- Webview - diagnostic explorer, context debugger, state machine visualizer
+- Status bar indicator
+- Commands
+- Log output channel