Structured paragraphs

Structured paragraphs with place and chart numbers

Write each nautical statement once, pick its type, and attach its place and chart numbers before you send it for review.

Pick the type that matches the statement

Choose one type when you create the paragraph. The type decides which fields the editor must complete and how readers find the paragraph later.

Aid to navigation

Use for lights, buoys, beacons and other aids. Add geography and at least one chart number.

Hazard

Use for shoals, wrecks, rocks and dangers. Add geography, chart number and the distance or bearing a mariner needs.

Anchorage

Use for anchorages and berths. Add geography, chart number, depth or holding notes when known.

Bridge and cable

Use for bridges, cables and overhead clearances. Add geography and chart number.

Regulation

Use for rules and official requirements. Add the source so a reviewer can check the wording.

General

Use for coastal description and distances where no other type fits. Add geography when it helps readers find it.

Caution

Use for a warning that must stand out in print and on the web. Keep it short and specific.

Note

Use for a short note that supports the paragraph it sits beside. Keep it as a separate typed paragraph.

Write a paragraph that is ready for review

Work through these steps in order. The editor checks the fields before it can move to in review.

  1. Open the chapter and add a paragraph

    Choose Paragraphs, open the chapter, select Add a paragraph, and pick a template for the type you need.

  2. Pick the type and write a title

    Select one type from the list on this page, then add a short title that names the place or feature.

  3. Write the text

    Enter the paragraph body in plain words. Keep one statement in one paragraph so it can be reused and linked to a change request.

  4. Add geography

    Enter the area or named place. Add latitude and longitude when you know them. Do not leave geography blank for aids, hazards, anchorages or bridges and cables.

  5. Add chart numbers and source

    Enter at least one chart number for those types, then add the source you checked. A reviewer will look for these fields first.

  6. Preview, save with a reason, and check the result

    Preview the paragraph as it will appear in print and on the web, save with a reason for the change, then confirm the version history shows your save before you send it for review.

  • Type is required and must be one of the types on this page
  • Geography and chart numbers are required before a paragraph can move to in review
  • Every save creates a version with who, when and why, and locks the paragraph while it is open

Reuse standard wording in one place

Save repeated wording once, insert it by reference, and correct it once so every chapter updates.

  1. Save the standard wording as a reusable block

    Open Templates, create a reusable block, pick its type and write the wording once.

  2. Insert the block where it belongs

    Open the paragraph, insert the block, and confirm it shows in the paragraph list.

  3. Check where it is used before you edit it

    Open the block detail and read the where used list. The list names every chapter that will change.

  4. Edit it once, with a reason

    Change the block once and save with a reason. The history records who changed it and why, and every use updates.

Find a paragraph when you need it

Filter the list, open the paragraph, and check its history before you change it.

  1. Filter by type, area, chart number, status and owner

    Set the filters that match the place or chart you need, then open the paragraph from the list.

  2. Read the detail before you edit

    Check history, where used, linked change requests, locked by and status. If another person holds the lock, wait or ask a publication manager.

  3. Save a new version, never edit a published copy

    Make your change as a new version with a reason. Published paragraphs stay locked so editions can be rebuilt exactly.