Jg/review readmes

[jjeangal]

This PR:

• Cleans up the espresso readme file.

---

• To see the specific tasks where the Asana app for GitHub is being used, see below:
  • https://app.asana.com/0/0/1213972506292741

[claude]

Claude finished @jjeangal's task in 2m 40s —— View job

---

Review of PR #400

• Gather context and read existing review comments
• Review changes to README_ESPRESSO.md
• Review changes to espresso/docs/README_ESPRESSO_CODE_SYNC_PROCEDURE.md
• Review changes to espresso/docs/README_ESPRESSO_DEPLOY_CONFIG.md
• Post review feedback

---

Summary

Nice cleanup overall. The reorganization is a clear improvement — moving detailed procedures into dedicated docs files, adding the "Quick start vs Manual setup" split for the devnet section, and fixing formatting throughout. Several real corrections too (sudo add group docker → sudo groupadd docker, espresso/scrips/ → espresso/scripts/, verfier → verifier).

Issues Found

Bugs (should fix before merge):

• github.com was capitalized to GitHub.com in 3 clone/documentation URLs (lines 10, 28, 214). While DNS is case-insensitive, SSH config matching can be case-sensitive and this is unconventional. Suggestions provided.
• .github/workflows/ was capitalized to .GitHub/workflows/ in 2 places (lines 475, 478). The actual filesystem path is lowercase .github. The filename update to espresso-enclave.yaml is correct.

Nit:

• Heading hierarchy: ## Development environment was changed to # Development environment, creating multiple h1s and h1→h3 jumps without h2. Consider reverting to ##.
• README_ESPRESSO_CODE_SYNC_PROCEDURE.md line 263: leftover sentence about "EOD next Monday" doesn't fit under the Docker image update step.

README_ESPRESSO_DEPLOY_CONFIG.md changes look good — the allocs.json generation steps are clear and well-formatted.

[gemini-code-assist]

Code Review

This pull request significantly restructures and updates the project documentation, primarily in README_ESPRESSO.md. It introduces a new quick-start guide using convenience scripts, provides detailed manual setup instructions via Docker Compose, and adds new commands for container management. Additionally, it migrates detailed procedures for code synchronization and deployment configuration into dedicated documentation files. Review feedback suggests correcting the casing of the .github directory in workflow paths to ensure compatibility and removing transient process notes regarding internal deadlines from the permanent documentation.

[shenkeyao]

Just a nit comment!