Starting assumption
Written instruction dumps are rarely the best way to teach a tool. I barely considered
a long help document and initially assumed a video tutorial would engage people more
naturally - one medium to explain the product to the outside world.
The friction problem
While building the app I had invested heavily in speed: a teacher can complete setup
in under a minute. Planning the video exposed a mismatch. Explaining Grupop often took
longer than using it. By the time a narration covered what the product was, a minute
could pass before setup even began. A walkthrough meant to prove simplicity was
becoming anything but simple for the viewer.
That would erode trust. If the product’s job is to take pressure off teachers,
asking them to risk four or five minutes on a tutorial before they even know whether
it is worth their time works against the brand. The medium was raising perceived
complexity and delaying the aha moment.
Experimentation: strip the medium back
To shorten time to understanding I iterated toward less, not more:
-
Captions instead of narration → short clips instead of one long walkthrough →
captioned stills instead of clips or GIFs.
-
Endpoint: if the “video” was only screenshots and captions, video itself
added friction (play, wait, scrub) without adding clarity.
The pivot: two audiences, two jobs
The deeper issue was not only length - it was scope. One artefact was trying to teach
what Grupop is, why it might help, and
how to use it. Those are different learning moments for different
audiences:
-
Pre-signup (prospects): product education - understand the value
proposition fast enough to decide whether to try it.
-
Post-signup (new users): first-run guidance / activation - orient
inside the real UI and reach time-to-value without a separate training course.
Treating “the flyer” and “the instruction manual” as the same
deliverable was the constraint. Separating them unlocked progressive disclosure: right
content, right stage.
Solution: clear paths for each stage
Pre-signup - Welcome page carousels.
Two carousels of six captioned screenshots on the landing page
(grupop.ie/welcome).
Carousel 1 explains core rewards mechanics in seconds. Carousel 2 introduces secondary
features for visitors who want more depth. Split this way, the core idea is scannable
immediately; deeper features are optional - speed and simplicity without dumping
everything at once.
Post-signup - five contextual hints.
Inside the app, screenshots were unnecessary: users are already in the product. After
a self-explanatory setup (<1 minute), five single-sentence hover hints appear on
the main classroom page - the hub teachers use day to day. Strict rule of five: no
multi-step modal tour, no mandatory walkthrough. Hints are dismissible. If more than
five tips were required to explain the core loop, the fix would be simplifying the UI,
not adding more guidance.