formatting

docs/java/reference/lifecycle.md

@@ -26,7 +26,7 @@ public record DBOSConfig(
     boolean adminServer,
     int adminServerPort,
     String conductorKey,
-    String appVersion,
+    String appVersion
 )
 ```
 
@@ -38,66 +38,25 @@ new DBOSConfig.Builder()
 
 **Methods:**
 
-```java
-Builder appName(String appName)
-```
-
-Your application's name. Required.
-
-```java
-Builder databaseUrl(String databaseUrl)
-```
-
-The JDBC URL for your system database. Required.
-A valid JDBC URL is of the form `jdbc:postgresql://host:port/database`
-
-```java
-Builder dbUser(String dbUser)
-```
-
-Your Postgres username or role. Required.
-
-```java
-Builder dbPassword(String dbPassword)
-```
-
-The password for your Postgres user or role. Required.
+- **`appName(String appName)`** - Your application's name. Required.
 
-```java
-Builder maximumPoolSize(int maximumPoolSize)
-```
+- **`databaseUrl(String databaseUrl)`** - The JDBC URL for your system database. Required. A valid JDBC URL is of the form `jdbc:postgresql://host:port/database`
 
-The maximum size for the system database connection pool created by DBOS.
+- **`dbUser(String dbUser)`** - Your Postgres username or role. Required.
 
-```java
-Builder connectionTimeout(int connectionTimeout)
-```
+- **`dbPassword(String dbPassword)`** - The password for your Postgres user or role. Required.
 
-The connection timeout for the system database connection created by DBOS.
+- **`maximumPoolSize(int maximumPoolSize)`** - The maximum size for the system database connection pool created by DBOS.
 
-```java
-Builder runAdminServer()
-```
+- **`connectionTimeout(int connectionTimeout)`** - The connection timeout for the system database connection created by DBOS.
 
-Whether to run an [HTTP admin server](../../production/self-hosting/admin-api.md) for workflow management operations. Defaults to true.
+- **`runAdminServer()`** - Whether to run an [HTTP admin server](../../production/self-hosting/admin-api.md) for workflow management operations. Defaults to true.
 
-```java
-Builder adminServerPort(int port)
-```
+- **`adminServerPort(int port)`** - The port on which the admin server runs. Defaults to 3001.
 
-The port on which the admin server runs. Defaults to 3001.
-
-```java
-Builder conductorKey(String key)
-```
-
-An API key for [DBOS Conductor](../../production/self-hosting/conductor.md). If provided, application is connected to Conductor. API keys can be created from the [DBOS console](https://console.dbos.dev).
-
-```java
-Builder appVersion(String appVersion)
-```
+- **`conductorKey(String key)`** - An API key for [DBOS Conductor](../../production/self-hosting/conductor.md). If provided, application is connected to Conductor. API keys can be created from the [DBOS console](https://console.dbos.dev).
 
-The code version for this application and its workflows. Workflow versioning is documented here.
+- **`appVersion(String appVersion)`** - The code version for this application and its workflows. Workflow versioning is documented here.
 
 ### DBOS.launch
 

docs/java/reference/workflows-steps.md

@@ -74,48 +74,15 @@ new StartWorkflowOptions()
 
 **Methods:**
 
-```java
-StartWorkflowOptions withWorkflowId(String workflowId)
-```
+- **`withWorkflowId(String workflowId)`** - Set the workflow ID of this workflow.
 
-Set the workflow ID of this workflow.
+- **`withTimeout(Duration timeout)`** / **`withTimeout(long value, TimeUnit unit)`** - Set a timeout for this workflow. When the timeout expires, the workflow **and all its children** are cancelled. Cancelling a workflow sets its status to `CANCELLED` and preempts its execution at the beginning of its next step.
 
-```java
-StartWorkflowOptions withTimeout(Duration timeout)
-```
+  Timeouts are **start-to-completion**: if a workflow is enqueued, the timeout does not begin until the workflow is dequeued and starts execution. Also, timeouts are **durable**: they are stored in the database and persist across restarts, so workflows can have very long timeouts.
 
-```java
-StartWorkflowOptions withTimeout(long value, TimeUnit unit)
-```
-
-Set a timeout for this workflow.
-When the timeout expires, the workflow **and all its children** are cancelled.
-Cancelling a workflow sets its status to `CANCELLED` and preempts its execution at the beginning of its next step.
+  Timeout deadlines are propagated to child workflows by default, so when a workflow's deadline expires all of its child workflows (and their children, and so on) are also cancelled. If you want to detach a child workflow from its parent's timeout, you can start it with `SetWorkflowTimeout(custom_timeout)` to override the propagated timeout. You can use `SetWorkflowTimeout(None)` to start a child workflow with no timeout.
 
-Timeouts are **start-to-completion**: if a workflow is enqueued, the timeout does not begin until the workflow is dequeued and starts execution.
-Also, timeouts are **durable**: they are stored in the database and persist across restarts, so workflows can have very long timeouts.
-
-Timeout deadlines are propagated to child workflows by default, so when a workflow's deadline expires all of its child workflows (and their children, and so on) are also cancelled.
-If you want to detach a child workflow from its parent's timeout, you can start it with `SetWorkflowTimeout(custom_timeout)` to override the propagated timeout.
-You can use `SetWorkflowTimeout(None)` to start a child workflow with no timeout.
-
-```java
-StartWorkflowOptions withQueue(Queue queue)
-```
-
-```java
-StartWorkflowOptions withQueue(Queue queue, String deduplicationId)
-```
-
-```java
-StartWorkflowOptions withQueue(Queue queue, int priority)
-```
-
-```java
-StartWorkflowOptions withQueue(Queue queue, String deduplicationId, int priority)
-```
-
-TODO: Document these once they're broken up appropriately.
+- **`withQueue(Queue queue)`** / **`withQueue(Queue queue, String deduplicationId)`** / **`withQueue(Queue queue, int priority)`** / **`withQueue(Queue queue, String deduplicationId, int priority)`** - TODO: Document these once they're broken up appropriately.
 
 
 ### runStep
@@ -153,26 +120,10 @@ Provide a name for this step.
 
 **Methods:**
 
-```java
-StepOptions withRetriesAllowed(boolean b)
-```
-
-Whether to retry the step if it throws an exception. Defaults to false.
-
-```java
-StepOptions withMaxAttempts(int n)
-```
-
-How many times to retry a step that is throwing exceptions.
-
-```java
-StepOptions withIntervalSeconds(double t)
-```
+- **`withRetriesAllowed(boolean b)`** - Whether to retry the step if it throws an exception. Defaults to false.
 
-How long to wait before the initial retry.
+- **`withMaxAttempts(int n)`** - How many times to retry a step that is throwing exceptions.
 
-```java
-StepOptions withBackoffRate(double t) 
-```
+- **`withIntervalSeconds(double t)`** - How long to wait before the initial retry.
 
-How much to multiplicatively increase `intervalSeconds` between retries.
+- **`withBackoffRate(double t)`** - How much to multiplicatively increase `intervalSeconds` between retries.