# IT Documentation Written From Solved Tickets

Source: https://maito.app/workflows/write-it-how-to-guides

Maito turns solved IT tickets into short how-to guides in your docs tool, notes where tickets disagree and leaves them unpublished for IT to review.

Turn solved IT tickets into short guides.

[IT and admin](https://maito.app/workflows/team/it-and-admin) · When you ask · Updated October 19, 2026

Works with

-   Slack
-   Email
-   Jira Service Management
-   ServiceNow
-   Freshdesk
-   Notion
-   [Confluence](https://maito.app/workflows/tool/confluence)
-   Box

## How do you write IT how-to guides?

To write IT how-to guides, point Maito at a solved ticket and your docs tool. It reads the ticket and linked ones, writes a short step-by-step guide, and saves it as an unpublished draft. It also flags where tickets differ, like a fix that applies to one floor, so the guide stays accurate.

## How it's done today

The same fix is explained again and again.

## What Maito does

1.  Read the ticket
2.  Write the steps as a guide

## Example

**Ben** (4:00 PM):

turn ticket ITS-1873 into a guide.

**Maito** (4:03 PM):

Drafted "Printer shows offline on Mac" in Notion under IT Guides. It's unpublished. I used ITS-1873 and the 2 tickets linked to it, ITS-1790 and ITS-1842.

• Join Northstar-Office, not Northstar-Guest.  
• Remove the printer in System Settings.  
• Add it again by IP, not the Bonjour name.  
• Print a test page.

6 steps in all.

**Catch:** ITS-1873 only covers the 2nd floor printer at 10.0.4.30. ITS-1842 shows the 3rd floor printer is 10.0.4.31, so the guide lists both.

Say when it's good to publish.

**Ben** (4:12 PM):

looks right. Publish it.

**Maito** (4:13 PM):

Published. I added it to the Printing index. The 3 tickets are still open. Want me to reply on them with the link and close them?

## How to set it up

When you ask Write IT how-to guides

Set up

Nothing to set up. Ask in Slack or by email whenever you need it.

Connect ticketing

-   Jira Service Management
-   ServiceNow
-   Freshdesk

Connect docs

-   Notion
-   Confluence
-   Box

Not connected yet? Your agent sends you a link to sign in.

## What it won't do

It can only write what the tickets contain, so a guide from a thin ticket stays thin. IT should test the steps before publishing.

## Questions

### Which tools does it use?

Tickets from Jira Service Management, ServiceNow or Freshdesk, and docs in Notion, Confluence or Box, connected through MCP.

### Does it publish the guide?

No. It saves a draft for IT to review and publish.

### Can it do this for many tickets?

Yes. Give it a list or a Loop to draft guides from recurring tickets, one at a time.

## More it and admin workflows

-   [Answer IT questions in the help channel People get answers to everyday IT questions without a ticket. IT and admin · When you ask Works with Slack, Email.](https://maito.app/workflows/answer-it-questions-in-the-help-channel)
-   [Handle access requests Access requests get collected, approved by the right person and logged. IT and admin · When you ask Works with Jira Service Management, ServiceNow.](https://maito.app/workflows/handle-access-requests)
-   [Review who has access Every quarter, check who has access to key tools and flag what looks wrong. IT and admin · On a schedule Works with Slack, Email.](https://maito.app/workflows/review-who-has-access)
-   [Guide people through buying something Purchases follow the process without people learning it first. IT and admin · When you ask Works with Slack, Email.](https://maito.app/workflows/guide-people-through-buying-something)
-   [Check a new vendor's security Get a first pass on a vendor's security docs before you sign. IT and admin · When you ask Works with Box.](https://maito.app/workflows/check-a-new-vendors-security)
-   [Track laptops and equipment Know who has which device and when warranties end. IT and admin · On a schedule Works with Airtable, Microsoft 365.](https://maito.app/workflows/track-laptops-and-equipment)

[See all workflows](https://maito.app/workflows)

## Put your AI teammate to work.

Set it up in minutes. Start with this one, and let it earn the next one.

[Put Maito to work](https://maito.app/login?returnTo=%2Fworkflows%2Fwrite-it-how-to-guides)[Book a demo](mailto:support@maito.app?subject=Maito%20demo)
