docs: expand authoring guide with writing style

Previously authoring-guide.md was a Zensical formatting reference only.
Expand it into a full authoring guide that covers both how to write
well for this project and how to use Zensical features.

New content:

- Writing style rules (no emdash, no passive voice, no listicles,
  no marketing language)
- SDK source verification requirement for code examples, with
  repo links and key source files per language
- "Revise, Don't Append" rule to prevent stale or contradictory
  prose when editing existing pages
- "Look Before You Write" rule to prevent duplicated or conflicting
  coverage across pages
- Language neutrality rules (tab order, notes inside tabs)
- Page structure template with exemplar pages
- Pre-commit checklist

Update CONTRIBUTING.md with both ways to run Zensical (activate venv
or run the binary directly), a common commands list, and an "Adding
New Pages" workflow.

Update README.md to use "durable execution" consistently, add the
Java SDK repo link, and simplify the authoring guide reference now
that it covers writing style as well as formatting.

Author: yaythomas

CONTRIBUTING.md

@@ -9,19 +9,32 @@ python -m venv ~/.venvs/zensical
 source ~/.venvs/zensical/bin/activate
 pip install zensical
 ```
-### Preview site locally
-Once installed, activate the venv and run Zensical from the repository root:
+### Running Zensical
+
+Once installed, either activate the venv or run the binary directly:
 
 ```bash
+# Option 1: Activate the venv
 source ~/.venvs/zensical/bin/activate
-
-# Live preview with hot-reload
 zensical serve
 
-# Production build
-zensical build --clean
+# Option 2: Run directly without activating
+~/.venvs/zensical/bin/zensical serve
 ```
 
+Common commands:
+
+- `zensical serve` — live preview with hot-reload
+- `zensical build --clean` — production build
+- Review build output for broken link warnings
+
+### Adding New Pages
+
+1. Create the markdown file in `docs/`
+2. Add the page to the nav section in `zensical.toml`
+3. Create corresponding code examples in all three languages under `examples/`
+4. Test locally with `zensical serve`
+
 ## Vendored dependencies
 
 The Zensical theme lazy-loads a few third-party assets (Mermaid for diagrams,

README.md

@@ -1,8 +1,7 @@
-# AWS Lambda durable functions developer documentation source
+# AWS Lambda durable execution developer documentation source
 
 This repository contains the source for the AWS Lambda Durable Execution SDK
-documentation website at https://docs.aws.amazon.com/durable-execution,
-providing comprehensive guides and references for building resilient,
+documentation website at https://docs.aws.amazon.com/durable-execution, providing comprehensive guides and references for building resilient,
 long-running applications with AWS Lambda durable functions across
 multiple programming languages.
 
@@ -40,10 +39,9 @@ pip install zensical
 zensical serve
 ```
 
-For the full authoring workflow — adding code samples, formatting conventions,
-commit messages, and pull request process — see
-[CONTRIBUTING.md](CONTRIBUTING.md). For Markdown formatting syntax, please see
-the [Authoring Guide](authoring-guide.md).
+For the full authoring workflow, please see [CONTRIBUTING.md](CONTRIBUTING.md).
+
+For writing style and Markdown formatting syntax, please see the [Authoring Guide](authoring-guide.md).
 
 ## Kiro Power
 
@@ -64,6 +62,7 @@ for details.
 - [AWS Lambda durable functions Documentation](https://docs.aws.amazon.com/lambda/latest/dg/durable-functions.html)
 - [JavaScript SDK Repository](https://github.com/aws/aws-durable-execution-sdk-js)
 - [Python SDK Repository](https://github.com/aws/aws-durable-execution-sdk-python)
+- [Java SDK Repository](https://github.com/aws/aws-durable-execution-sdk-java)
 
 ## Feedback & Support