PR: docs(cowork): Add “What is Cowork” article in EN, PT, ES
Summary
This PR introduces the first article of the Cowork documentation series: “What is Cowork” — a comprehensive guide to the TESS AI collaborative platform for autonomous agents.Highlights
- ✅ Trilingual Documentation: English, Portuguese, Spanish
- ✅ Complete Article: 800+ lines covering 10+ sections
- ✅ Navigation Updated: Added Cowork section to docs.json for all 3 languages
- ✅ Visual Assets: Screenshot placeholders with detailed specs
- ✅ Production-Ready: MDX with Mintlify components
Changes
Files Modified
- docs.json — Added Cowork group to Features tab (EN, PT, ES)
Files Added
English
en/cowork/what-is-cowork.mdx(519 lines)
Português
pt/cowork/o-que-e-cowork.mdx(translated)
Español
es/cowork/que-es-cowork.mdx(translated)
Assets
images/cowork/main-canvas.png(placeholder)images/cowork/hire-modal.png(placeholder)
Content Coverage
Sections Included
- What is Cowork — Platform overview
- Why Cowork? — Problems solved by autonomous agents
- The Mesh Canvas — Visual representation with screenshot
-
What You See on the Mesh — Interface components:
- Agent Nodes (Avatares)
- Team Presence (Orbs)
- Documents & Artifacts
- Connections & Links
-
Core Concepts — 4 key features:
- Digital Employees (Autopilots)
- Artifacts (Persistent outputs)
- Squads (Multi-agent teams)
- Sync Sessions (Real-time coordination)
- Getting Started — 5-step onboarding flow
- Key Features at a Glance — Feature table
- Next Steps — Links to related docs
- Pro Tips — Best practices
Screenshots Required
Before merge, please add these 2 images:1. images/cowork/main-canvas.png
- Description: Mesh Canvas Overview
- Content: Full Cowork interface showing:
- Left sidebar (navigation: Cowork, Spaces, Agent Studio)
- Main canvas area with agent nodes/avatars (Gabriel, Tess)
- Top toolbar (search, Hire button, controls)
- Bottom input area (prompt box)
- Dimensions: Wide-angle view of entire workspace
- Spec: JSX comment in
en/cowork/what-is-cowork.mdx(lines 25-33)
2. images/cowork/hire-modal.png
- Description: Digital Employee Hiring Form
- Content: Modal “Contratar um novo colaborador” showing:
- Avatar image field with Change/Remove options
- Name input (e.g. “Lead Scanner”)
- Voice selector dropdown
- Meta/description textarea
- Work Instructions textarea
- “Melhorar com IA” button
- Work Mode section
- “Contratar” button (top-right)
- Dimensions: Modal dialog ~500px width
- Spec: JSX comment in
en/cowork/what-is-cowork.mdx(lines 63-76)
Localization Quality
- ✅ English: Native-level technical terminology
- ✅ Português (BR): Natural Brazilian Portuguese with local idioms
- ✅ Español: Neutral Spanish suitable for LATAM
Preview URLs
Once merged:- English:
https://tess.ai/docs/cowork/what-is-cowork - Português:
https://tess.ai/docs/pt/cowork/o-que-e-cowork - Español:
https://tess.ai/docs/es/cowork/que-es-cowork
Related
- Linear Issue: TESS-1127
- Screenshot Source: Cowork staging environment (
s1-tech.tess.im)
Testing Checklist
- Screenshots added to
/images/cowork/ - Mintlify preview loads correctly
- Navigation shows Cowork section for all 3 languages
- Links to next articles are valid (once created)
- No broken references in JSX comments
- Images display with correct captions
- Responsive on mobile/tablet
Next Steps
- ✅ Approve and merge this PR
- ⏳ Create next article: “Primeiros Passos > Acesso ao Cowork”
- ⏳ Create next article: “Digital Employees > Criando um Digital Employee”
- ⏳ Build out remaining TIER 1 articles
- ⏳ Move to TIER 2 (Colaboration, Artifacts Avançado, etc.)
Author Notes
- Used Mintlify components:
<Frame>,<Tip>,<Steps>,<Step>for interactivity - Followed DESIGN.md rules for consistency
- Maintained SEO-friendly structure with clear hierarchy
- Ready for immediate publication once screenshots added