Operations at a glance
Operations is the hub for reviewing active documentation work and deciding what to do next. Use it when you need to see generation results, AI usage, credit usage, chat-answer activity, attention items, or recent jobs in one place. The hub sits after work starts and before you open a status, history, or analytics detail page.
| If you need to… | Go to |
|---|---|
| See the current generation, AI-spend, credit, and chat-answer summary | Understand the Operations hub |
| Review insight groups for a project | Find the work area you need |
| Start or resume work from a project or repository | Start or resume documentation work |
| Interpret an empty or unavailable area | When a work area is empty or unavailable |
| Follow a job after reviewing the hub | Know what to open next |
| Review projects | Projects overview |
| Create a project | Create a project |
| Start documentation work | Run documentation work |
| Interpret job statuses | Documentation job status reference |
| Follow generation stages | Documentation generation lifecycle |
| Follow synchronization states | Synchronization job states |
| Review job history | Job History |
| Review measurements after work runs | Analytics overview |
Before you start
An authenticated session gives you access to the Operations data for your organization. Manual insights is the project-specific area for reviewing weak pages, topic gaps, and coverage gaps. It first loads the organization's projects, then loads insights for the selected project. When no project is selected, the first project returned becomes the initial selection.
Prerequisites
- Be signed in to Atloria.
- Have at least one project available if you need Manual insights.
- Know which project's insights you want to review when more than one project is available.
Find the work area you need
Use Operations to open a project-specific insight view. The application navigation includes Home, Ops, and Operations.
Open Operations
Steps
- Select Operations in the application navigation.
- Confirm that the page heading is Operations.
Result: The Operations hub is on screen.
Choose a project for Manual insights
The Project selector is a list of projects, not a fixed list of labels. Each option uses the project name for display and the project record's ID as its value. The list appears when more than one project is available.
Steps
- In Manual insights, open Project selector.
- Select the project whose insight groups you want to review.
Result: The Manual insights area loads for the selected project.
If no projects are available and there is no loading error, Manual insights has no content to show. Use the project work area to create or open a project instead.
Understand the Operations hub
The Operations hub is a read-only summary of current documentation activity, attention signals, AI usage, recent jobs, and queue counts. Needs attention groups collect the attention signals that may need follow-up. Read the summary first, then use the detailed groups to decide which work area to open.
| Area | What to read |
|---|---|
| Generation success | The generation success rate and the completed-versus-total job count. |
| AI spend (actual) | Actual spend and the token count for the displayed period. |
| Credits | Current credits and lifetime spend. |
| Deflection rate | Answered, escalated, refused, positive-feedback, and negative-feedback counts. |
| Needs attention | Escalations, Chat refusals, 👎 answers, and Search misses. |
| AI spend by model | Model, Operation, Calls, Tokens, and Cost. |
| Recent jobs | When, Status, Stage, Docs, Duration, and Error. |
| Queues | Waiting, active, failed, and delayed counts for each displayed queue. |
The attention cards can contain up to six entries each. The model table can be empty, and the recent-jobs table shows the operational rows returned for the page. Work from the headers and values currently visible in these tables.
Start or resume documentation work
The Dashboard is the starting area for project work. Its summary shows the project count, generation count for the last seven days, and chat answers for the last seven days. Its Recent projects table shows Project, Docs, Categories, and Updated for the first three projects.
Open an existing project
Steps
- In Recent projects, select the project row you want to open.
Result: Atloria opens that project's page.
When more than four projects are available, the link beginning View all appears beside Recent
projects. Select it to open the full project list.
Start a project from a repository or without one
Prerequisites
- Decide whether you are connecting a repository or creating the project without one.
- If you are connecting a repository, have its URL available.
Steps
- In the repository scene, choose one route from the table.
| If you want to… | Select |
|---|---|
| Enter a repository URL | Project repository URL |
| Continue with a recognized repository URL | Get Started → |
| Connect GitHub | GitHub |
| Connect GitLab | GitLab |
| Connect Bitbucket | Bitbucket |
| Create without connecting a repository | Create without a repository |
Result: The wizard follows the route you selected and remains in the project-creation work area until you complete its next step.
When a work area is empty or unavailable
Use the exact message on screen to decide whether to wait, correct a repository URL, or move to the work area that supplies the missing project context.
| What you see | What it means | What to do |
|---|---|---|
Loading operations… | Operations data is still loading. | Wait for the hub to finish loading. |
Operations failed to load. | The Operations request failed. | Review the displayed error text and retry from the Operations page. |
Loading insights… | Manual insights are loading for the selected project. | Wait for the insight groups to load. |
Insights failed to load. | The Manual insights request failed. | Review the displayed error text and retry after confirming the project selection. |
Nothing — clean week. | A Needs attention group has no rows. | Continue with the other groups on the hub. |
No AI usage in the last 7 days. | No AI model rows are available for the displayed period. | Use the other summary and job information on the hub. |
No weak pages — nice. | The Weak pages group has no rows. | Continue with the other insight groups. |
No gaps in the last 7 days. | The Topic gaps group has no rows. | Continue with the other insight groups. |
No code snapshot for this project yet. | The project has no code snapshot for Coverage gaps. | Continue with the project work area. |
Please enter a valid GitHub, GitLab, or Bitbucket repository URL | The repository URL is not recognized as a supported repository URL. | Enter a valid GitHub, GitLab, or Bitbucket repository URL. |
Know what to open next
After you review Operations, continue with the page that matches the decision you need to make.
| If you need to… | Open |
|---|---|
| Start or monitor documentation jobs | Run documentation work |
| Understand a job's displayed status | Documentation job status reference |
| Follow generation from its first state to its outcome | Documentation generation lifecycle |
| Follow synchronization work | Synchronization job states |
| Review completed operational work | Job History |
| Measure results after work runs | Analytics overview |
Steps
- Review the summary and detailed tables on Operations.
- Select the destination that matches the work you need to continue.
Result: The next work area is on screen for the decision you made from the Operations hub.
Was this page helpful?