JOATOSIT Operations Platform
Browse documentation

External documentation links

↩ Administration

Records in JOATOS can carry links to documentation held elsewhere — a vendor manual, a wiki page, a runbook, a supplier portal.

Sites, devices, servers, services, software, licenses, domains and assets all support them. Each link is a title and a URL, listed on the record.

The point is that the link lives on the thing it describes. Someone troubleshooting a switch at 2am finds its manual on the switch's page, rather than knowing which wiki to search.

Who can add them

Editing a record's links follows that record's own module permission — if you can edit the device, you can edit its links. There's no separate permission to manage.

Notes & tips

  • Prefer a link to copying content in. A copied procedure goes stale silently; a link doesn't.
  • Title links for the person who'll need them, not the system they point at: "Switch stack firmware upgrade procedure" beats "Vendor KB 41822".

Related