Write IT how-to guides
Turn solved IT tickets into short guides.
IT and admin · When you ask · Updated
Works with
- Slack
- Jira Service Management
- ServiceNow
- Freshdesk
- Notion
- Confluence
- Box
Slack
Jira Service Management
ServiceNow
Freshdesk
Notion
Confluence
BoxHow 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
- Read the ticket
- Write the steps as a guide
Example
@Maito turn ticket ITS-1873 into a guide.
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.
@Maito looks right. Publish it.
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?
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
- 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
Tickets from Jira Service Management, ServiceNow or Freshdesk, and docs in Notion, Confluence or Box, connected through MCP.
No. It saves a draft for IT to review and publish.
Yes. Give it a list or a Loop to draft guides from recurring tickets, one at a time.
