8000 Add a current first-Submission guide for BAP, HAP and CAP · Issue #563 · jra3/mulm · GitHub
[go: up one dir, main page]

Skip to content

Add a current first-Submission guide for BAP, HAP and CAP #563

Closed

Description

@jra3

Part of #558.

Outcome

A newcomer can understand how to participate without reconstructing today's Portal workflow from the external 2009 manual and points spreadsheet. Add a concise guide reachable from Home and the Submission form.

Acceptance criteria

  • Explain choosing a Program and Species, creating/submitting a report, arranging a Witness through the established club process, the applicable waiting period, bringing specimens to a meeting, and committee approval.
  • Give a brief BAP, HAP and CAP example, using current CONTEXT.md and accepted lifecycle ADRs as authority. Link relevant official rules; do not invent quantities, meeting dates or a new contact channel.
  • Explain that the Witness settles Species and provisional points, points count only after approval, and Member edits to submitted work void the Witness. Explain that the Member does not manually enter the approval queue.
  • Link the existing Submission actions and explain the established route for questions/corrections. Confirm any undocumented witness-arrangement instructions with the committee before publishing them.
  • Keep the guide readable on mobile and available before sign-in, with meaningful link text. Check its links and wording against the current app; review it on public staging with chikin-farm.

Blocked by

None technically. Recommended after the report fixes so examples describe the completed report experience. Undocumented club logistics must be resolved before adding those specifics.

This is a usability improvement inferred from the navigation and current content, not a claim of measured signup abandonment.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationpriority:mediumMedium priority - important but not urgentready-for-agentFully specified, ready for an AFK agentui/uxUser interface and user experience improvements

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions

      0