Last Updated: 8/13/2026
Jolli Spaces
A Space is where documentation lives in Jolli. You bring your existing docs in (or generate them from code); the Jolli Agent and Gap Analysis keep them in sync as the code changes; every edit passes through review before going live. When you’re ready to share, you publish a Site from the Space.
What lives in a Space
- Articles. The core unit of content. Markdown by default; JSON content type for OpenAPI specs.
- Folders. Group Articles. Nestable, drag-and-drop.
- Sources. External inputs (GitHub repos) the AI reads to import, generate, and detect drift.
- Changesets. Edits the Jolli Agent or Gap Analysis proposes, batched for review before they go live.
- The Jolli Agent. Jolli’s AI agent, in its own tab. See The Jolli Agent.
Sorting and filtering
The controls above the Article tree let everyone browsing the Space narrow what they see:
- Sort - Default (the Space’s manual order), Alphabetical, Last Updated, or Created. Each has ascending/descending variants.
- Filters - restrict to Articles updated in a window (Today / Last 7 days / Last 30 days / Last 3 months / a custom date) and/or by creator name.
Who Spaces is for
Teams and individuals. On signup, Jolli creates a Personal Space for you so you have a place to work right away. Jolli also provisions a ready-made Shared Space - seeded with a Welcome doc - so your team has somewhere to collaborate from the start. Create additional shared Spaces any time.
Your first sign-in lands on Set up Jolli for your team rather than in a Space. That page explains how work reaches this workspace and how to install Jolli Memory; the Spaces are waiting behind it, and the sidebar takes you there whenever you want.
There is a cap on how many shared Spaces an organization can have. When you reach it, creating another is refused with a message naming your limit, and you either delete a Space you no longer need or contact support@jolli.ai to have the limit raised. Your Personal Space does not count toward it.
Finding your way around
Favorites
The sidebar shows a Spaces section and a Sites section, each capped at six items so the list stays scannable. Hover any Space or Site and click the star to pin it as a favorite.
- Favorites sort to the top of their section (alphabetically), then remaining slots fill with your other Spaces or Sites.
- A pinned item shows a filled star; hover an unpinned one to reveal its empty star. Click again to unpin.
- If you have more than six favorites in a section, all of them show and the cap is lifted.
- View all shared spaces / View all sites appears only when some items are hidden by the cap - click it to open the full list.
Favorites are per-section: starring a Space has no effect on the Sites list, and vice versa. Your Personal Space and any Jolli Memory Spaces (Spaces populated by Jolli Memory, Jolli’s dev-context capture tool) aren’t part of the Spaces favorites list - they have their own spots in the sidebar (Jolli Memory Spaces live under the Memory section).
Your Personal Space in the sidebar
Your Personal Space has a fixed spot in the sidebar (the Personal Space entry, marked with a person icon), separate from the shared Spaces list. Click it to jump straight to your own private Space.
- It’s the single-user Space Jolli creates for you on signup - a place to draft and experiment before anything is shared.
- It never appears in the shared Spaces list or its favorites, so team Spaces and your private one stay visually distinct.
- If your account is deleted, Personal Spaces are removed rather than transferred to an admin (unlike shared Spaces). See Settings.
Onboarding
On first sign-in, the Jolli Agent runs a guided walkthrough that generates documentation fresh from your source code. If you already have docs, it reads them as a signal for audience and structure - but still generates from the code so the output stays current.
To bring existing Markdown in as-is instead, use Import from GitHub - a connected GitHub repo, or a public repo URL (no authentication needed) - to pull .md files straight into a Space.
Once you kick off generation, Jolli creates a new Space and offers next steps, such as creating a Site from it.
Creating a Space after the first one
Every Space you create later starts from the same dialog, which opens with How would you like to get started? and three choices:
| Choice | What it does |
|---|---|
| Use your own repository as content storage | Content lives in your own GitHub repository. The Space is created first, then you connect the repository on its Storage tab. This is the default when it is available. |
| Guided setup | Connect a repository and generate documentation from it, the same walkthrough as first sign-in. Adds two steps: pick the repository, then choose whether to import existing Markdown or generate from the code. |
| Start from scratch | An empty shared Space. Pick this when you intend to write in Jolli rather than mirror a repository. |
The first option is the one to choose if the repository should stay the source of truth, since that is what enables git-backed publishing and pull-request review. See Managing a Space for the Storage tab, and The Jolli Agent for how generated content is reviewed.
What the import does
For a typical docs folder (dozens of files), expect a few minutes. The Agent:
- Preserves your folder structure where it makes sense.
- Imports Markdown only (
.md/.mdx). Other formats - RST, AsciiDoc, Textile, and anything non-Markdown - are skipped. - Flags issues it finds for you to resolve, rather than silently rewriting them (see below).
Two things the import does not do automatically - the Jolli Agent offers each as a follow-up step:
- Images. Imported images still point back to the source repository, so your published Site depends on it staying available. The Agent can re-upload them to Jolli so they’re self-hosted instead.
- Internal links. File-path links from the original repo won’t resolve in Jolli; the Agent can match them to the imported Articles and rewrite them on request.
Imports land directly in the Space - no Changeset review on the import itself. Edits you make later from the Jolli Agent chat (and AI-proposed updates from Gap Analysis) do flow through Changesets.
Sources
A Source is where a Space pulls external content from.
| Kind | What it is | Auth |
|---|---|---|
| GitHub App | Private (or public) repos via the Jolli GitHub App. | Install once per org; read-only contents and metadata. |
| Public GitHub repo | Any public repo by URL. | None. |
Sources drive three things: the initial import, ongoing Gap Analysis drift detection, and optional Generate from code. See The Jolli Agent for how Gap Analysis reads them.
The two-layer model
Sources live at the organization level, not per-Space. One connected Source can feed any number of Spaces.
- Organization Sources - managed at Settings → Sources. A GitHub App installation is one row at this level.
- Space Sources - each Space picks which organization Sources it consumes, under Space Settings → Automation.
Connect once; link from any Space.
Connecting
GitHub App. Settings → Sources → Connect Source → GitHub App routes you to GitHub’s install page. Pick the org and repos (All repositories or Selected). If your org admin needs to approve third-party apps, they review the read-only permissions before allowing.
Public GitHub repo. Settings → Sources → Connect Source → Public GitHub Repo. Paste the URL.
Once connected, link a Source to a Space under Space Settings → Automation → Add sources.
Sync
Connected Sources stay live. Two modes per Source:
- Webhook events - near-real-time, default for GitHub App Sources.
- Scheduled polling - for cases where you’d prefer suggested changes be aggregated.
Tracked branch (and which repos a GitHub App can see) is configurable per Source under Settings → Sources → Configure. The choice between webhook-driven and scheduled sync lives per Space under Space Settings → Automation, because the same Source can feed multiple Spaces with different cadences.
Source statuses
- Connected - working normally.
- Needs Attention - usually a lapsed permission or auth issue. Click in to see the cause.
Each Source’s menu has Manage (which Spaces use it, recent activity), Configure (tracked branch, sync mode), and Disconnect (removes from the organization; previously imported Articles stay in their Spaces).
Generate from code
If your repo has no existing docs, the Jolli Agent can write Articles directly from the codebase. You can also trigger it later by asking the Agent to generate docs for a specific part of a connected Source.
Generate is slower and more variable than Import - output quality scales with how well-commented the code is and how clear module boundaries are. If you have any existing docs, even rough Markdown READMEs, Import is faster and more reliable.
Next steps
- Editing & Organizing - the article editor and organizing a Space.
- The Jolli Agent - the AI agent, Changesets, and Gap Analysis.
- Jolli Sites - publish the Space at a URL.