> For the complete documentation index, see [llms.txt](https://docs.paragontruss.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.paragontruss.com/markup/welcome-to-paragon-markup.md).

# Welcome to Paragon Markup

Review, annotate, seal, and return truss design drawings.

Paragon Markup is where engineers review, annotate, seal, and return truss design drawings (TDDs). When a Paragon user requests seals or repairs for a shared set of trusses, the request arrives in Paragon Review. Review is the dashboard for those jobs; Markup is where the work is done.

In Markup, the engineer:

* examines the designs;
* adds any annotations or markups they need;
* adds the cover and back pages from templates;
* applies their seal, signature, and the date;
* returns the sealed drawings to the person who requested them.

## The three Paragon apps you'll use

| App                                                    | What you do there                                                                                                                                |
| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| [Paragon Accounts](https://accounts.paragontruss.com/) | Register your seals and signatures.                                                                                                              |
| [Paragon Review](https://review.paragontruss.com/)     | Your dashboard for jobs. Manage the jobs sent to your organization, create practice jobs, open a job in Markup, and download the finished files. |
| Paragon Markup                                         | Customize and manage templates, review truss designs, markup TDDs with annotations, apply seals and signatures, and return or reject jobs.       |

Review and Markup open in separate browser tabs. Clicking `Open Job` in Review opens that job's TDDs in Markup.

## The workflow at a glance

The first two stages are used for setup and maintenance. The third is what you repeat for every job.

| Stage                             | What happens                                                                                                                                              | Where                                                           |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
| 1. Register seals and signatures  | Add an electronic seal for each state in which you are licensed, and at least one signature with a transparent background.                                | Paragon Accounts (needs permissions enabled by Paragon Support) |
| 2. Customize your templates       | Upload the sealing templates provided by Paragon Support and save them as organization templates under their exact names. Modify the templates as-needed. | Markup                                                          |
| 3. Review, seal, and return a job | Open the job, review it, mark it up, seal it, and return the sealed drawings.                                                                             | Review, then Markup                                             |

## Where to start

New to Markup? Work through these in order:

1. [Before You Start](https://docs.paragontruss.com/markup/before-you-start)
2. [Register Seals and Signatures](https://docs.paragontruss.com/markup/before-you-start/register-seals-and-signatures)
3. [Create a Practice Job](https://docs.paragontruss.com/markup/before-you-start/create-a-practice-job)
4. [Create and Set Up Sealing Templates](https://docs.paragontruss.com/markup/how-to-guides/create-and-set-up-sealing-templates)
5. [Seal and Return a Job](https://docs.paragontruss.com/markup/how-to-guides/seal-and-return-a-job)

Keep [Must-Knows](https://docs.paragontruss.com/markup/reference/must-knows) handy. It's a one-page cheat sheet of settings, conventions, and workflows.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.paragontruss.com/markup/welcome-to-paragon-markup.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
