Tutorial development

Sequence and access convention

The first tutorial, LandWeave learner tutorial, gives learners a flavour of the system and introduces the Firefox role tabs through a complete workflow. It requires multiple roles and is an exception to the single-role convention below.

For every tutorial that does not require multiple roles:

  • Let learners use either an appropriate existing role tab or an ordinary username/password login with the required dataset access.
  • State the required role and dataset near the top. Recommend Viewer for inspection exercises; require Editor for authoring exercises. Specify Reviewer or Approver when the exercise requires their particular decisions. A higher role alone does not substitute for an exact workflow role.
  • Add a short access note linked to Tutorial access. Tailor the role to the exercise; do not repeat launcher installation steps.
  • Use the same exercise steps for both access methods. Keep navigation in the chosen tab when the exercise relies on parcel selection, which is tab-scoped.
  • Do not require the Firefox launcher for a single-role tutorial. Its Firefox requirement belongs to the launcher, not ordinary username/password access.

Suggested opening note for an inspection tutorial:

!!! note "Access for this tutorial"
    Use the **Viewer** tab from the first tutorial, or sign in with a
    username and password for an account with Viewer access to the training
    dataset. Stay in that tab throughout the exercise. See
    [Tutorial access](tutorial-access.md) for both options.

For a tutorial that requires multiple roles, state the participating roles and handoffs explicitly. Retain the demo-only explanation when one learner acts in several roles. Do not present one fixed account as sufficient for that flow.

Preparing an exercise

  • State the learning outcome, prerequisites, and whether parcel data changes.
  • Use synthetic training data and trainer-assigned examples. Do not publish passwords, tickets, session information, or personal data in screenshots.
  • Check the current interface using the exercise's stated role before writing exact button labels or capturing screenshots.
  • Give each step an observable result and finish with a short learner task.
  • Link to reference pages for optional detail, keeping the main exercise focused.

Second tutorial: Introducing LandWeave

The Introducing LandWeave tutorial follows the first tutorial in the User Guide. The outline below records its scope. Allow approximately 10–15 minutes; this is a learner estimate, not a measured usability result.

Outcome: learners can orient themselves, find a parcel, inspect its official information and history, and move between map and list in one session. Recommend Viewer access to the trainer's synthetic dataset. The exercise changes no parcel data and requires no role handoff.

  1. Choose your session. Start with the standard access note. Confirm the account, role, and active dataset. Explain that the dataset determines the collection of parcels being explored.
  2. Find your way around. Introduce Home, Documentation, Parcel Map, Parcels List/Search, and the profile indicator. Explain that available actions depend on access. Identify the small set of destinations used in this exercise.
  3. Read the map. Pan, zoom, fit the dataset, and identify a parcel. Briefly show labels and the background selector using a configured background. Explain that changing the background changes presentation, not parcel data.
  4. Find the same parcel in the list. Search for a trainer-supplied parcel identifier, inspect the result, and clear the filter. Show how filtering results differs from selecting parcels.
  5. Inspect a parcel. Open its detail page and read the identifier, key attributes, and geometry. Show surrounding parcels and zoom out to establish context, building on the first tutorial.
  6. Connect map and list. Select a small set of parcels, move between map and list in the same tab, use Only selected items, and clear the selection. Explain that separate tabs can have separate selections.
  7. Recognise official information and proposed changes. Inspect an example with version history and, where visible to Viewer, related draft information. Briefly relate these to the first tutorial's approval flow. Validate the example and role visibility before writing the detailed instructions.
  8. Try it independently. Ask learners to find another assigned parcel, report two attributes, inspect its surroundings, and return to an unfiltered map/list with the selection cleared.

Use approximately six to eight screenshots, each supporting an action or observable result. Verify the complete route once in an existing Viewer tab and once with an ordinary Viewer login. Check links and build the documentation in strict mode before publication. Detailed editing, snapping, split/merge, imports, exports, and review decisions belong in later focused tutorials.

Focused tutorial roadmap

After the two introductory tutorials, develop focused sets in this order:

  1. Draft review workflow. Create and submit a draft, reject it with a reason, create a corrected replacement, review it, approve it, and inspect both audit trails. Covers UJ-DRAFT-002 and UJ-DRAFT-003.
  2. GeoPackage editing round trip. Export approved parcels, edit the GeoPackage in QGIS, upload and preview it, create drafts, and complete the workflow. Explain declared CRS and exact-geometry preservation. Covers UJ-EXCH-001 and UJ-UPLOAD-001.
  3. Parcel split and merge. The first focused exercise is now Merge parcels, then split them equally: complete an approved edge-connected merge, then split its result into two equal-area parcels. A later advanced exercise can demonstrate corner-only rejection and conflict rollback. Together these cover UJ-TOPO-001, UJ-TOPO-002, and UJ-TOPO-004.
  4. Snapping and boundary editing. The first focused exercise is now Create a parcel with snapping: configure point and edge snapping, preview both candidate types, commit a corner snap, and save a new-chain draft from the main map. A later advanced exercise can add boundary tracing, coordinate inspection, provenance, and authoritative geometry verification after reload. Together these cover UJ-SNAP-002 and geometry preservation.
  5. Overlap detection and resolution. Interpret the live advisory, correct a proposal, and distinguish browser guidance from authoritative PostGIS enforcement. Covers UJ-OVERLAP-001 and UJ-OVERLAP-002.
  6. Dataset access and roles. Switch datasets, compare exact role capabilities, verify non-disclosure, and demonstrate separation-of-duties denials. Covers UJ-ACCESS-001, UJ-ACCESS-002, and UJ-ROLE-001.
  7. Administration without workflow authority. Manage users, grants, datasets, and map catalogues while showing that system administration does not confer parcel workflow authority. Covers UJ-ROLE-002.

Each focused tutorial should remain independently resettable and should name its required starting state. Reuse the role tabs when several exact roles are required, but do not repeat launcher installation instructions.