Build Your First Learning Portfolio - Article
Summary
A first learning portfolio should help a defined audience perform important tasks, make better decisions or meet a meaningful requirement. Start from those outcomes and the expertise you already have, then choose the content and delivery formats that support them.
Build one complete example before scaling production. Use the working design to establish review, accessibility, ownership and reusable patterns, while keeping enough flexibility for different learning needs.
Use this article to:
- Turn audience needs into a focused first portfolio
- Choose suitable native content, media, interactions and assessment formats
- Build reusable page and Course patterns without confusing them with delivery offers
- Establish a practical production, review and maintenance process
- Connect finished content to a useful learner journey and evidence
Start with the task the learner needs to perform
Ask what the person should be able to do after the learning, in the circumstances where they will use it. “Understand battery technology” is broad. “Choose a suitable battery storage approach for a small renewable-energy installation and explain the trade-offs” is more useful for designing content and evidence.
Collect the questions people already ask, mistakes that create support work, decisions that delay adoption and tasks that depend on specialist knowledge. Validate the need with the audience or the people who support them. Training is useful when a knowledge or practice gap contributes to the problem; a missing tool, contradictory procedure or unavailable resource may require another intervention.
Choose a small first portfolio with a clear progression. For example, an academy might introduce safe energy-storage concepts, provide a product-specific commissioning lesson and offer a facilitated practical assessment. The commercial or operational goal explains why these belong together; the content design explains what each one enables.
Plan the portfolio as offers, content and evidence
| Design decision | Practical question | Example |
|---|---|---|
| Audience and prerequisite | Who is this for, and what must they already know? | New service partners who have completed the introductory product orientation |
| Useful outcome | What should the person be able to do? | Identify the correct commissioning checks and respond to common warning conditions |
| Learning experience | Which explanation, example and practice will prepare them? | A short native Course with a worked scenario, a demonstration video and guided checks |
| Evidence | What result is appropriate to the claim? | A knowledge check for recall, or an instructor-reviewed Assignment for applied work |
| Delivered offer | How will people receive and complete the learning? | A Training Activity with the relevant modules, audience, enrollment and certification conditions |
| Maintenance | Who owns the accuracy and when should it be reviewed? | A named product specialist and academy owner, with review when the procedure or product changes |
Keep the learning claim proportionate to the evidence. A page view is useful engagement evidence, but it does not establish practical proficiency. A confirmation can record an acknowledgement, but it should not be presented as an independently observed performance assessment.
Choose formats by their teaching purpose
You do not need a different tool for every idea. Choose the simplest format that explains the concept, lets the learner practice or creates the evidence required.
| Purpose | Useful format | Design consideration |
|---|---|---|
| Explain a process or decision | Native text, a clear diagram and a worked example | Keep essential instructions in readable text; use the visual to clarify relationships |
| Demonstrate a task or scenario | A native video with appropriate subtitles and navigation | Show the task at a useful pace and provide written context for what the learner should notice |
| Practice knowledge or recognize errors | An appropriate H5P interaction or Question Set | Use plausible alternatives and feedback that explains the decision |
| Apply knowledge to real work | An Assignment with a clear brief and assessment criteria | Name the responsible instructor and plan feedback and marking capacity |
| Discuss judgment or experience | A facilitated Event, Comments object or relevant Community connection | Make the purpose and facilitator’s follow-up explicit |
| Look up detailed continuing guidance | A maintained document or optional Resource Library collection | Keep reference access and document ownership clear; do not turn every manual into compulsory course pages |
Use Create and Reuse Interactive Learning with H5P and Build Quizzes and Assessments with Question Set for interactive content and Question Sets. Assignments explains applied assignments, while Use Course Comments and Discussions for Learning explains comments and Community connections in native Courses. The format should serve the task, rather than demonstrate how many features the platform offers.
Build one complete native Course pattern
Open Courses and select Create to establish the native Course and its page outline. Build a short, realistic example with an introduction, an explanation, a worked case, practice and the intended next action. Review its navigation and content before multiplying the pattern.
A Page template supplies a single page’s starting layout or guidance. The Course builder structure comes from the pages you create and arrange. A whole Course used as a source template can instead provide a complete structure with targeted guidance. This is a useful way to support different course purposes, audiences or brands without forcing every author to start from an empty outline.
Keep the protected page title and Course banner behavior in mind when preparing reusable layouts. A page title supports navigation even when its visual position changes; the introductory Course page also retains its protected banner. Follow Create and Structure a Native Course for the builder model and Build Course Pages with Layouts, Text, Images, and Buttons for page layouts and the banner procedure.
A reusable Course pattern might contain an “Outcome and context” page, two task-focused sections, a decision exercise and a closing action. Use meaningful instructional guidance for the author, not filler intended to survive into the finished Course. Clone the source Course when a full targeted structure will save work, then replace all sample guidance and assets deliberately.
Write and arrange pages for use, not only appearance
Give each page a clear purpose. Introduce the problem, explain the relevant idea, show it in context and ask the learner to apply it where useful. Break a dense manual into task-focused guidance only when doing so improves the learning; avoid creating dozens of tiny pages merely to make the outline look substantial.
Use columns where they establish a useful relationship, such as an explanation beside an image or a worked example beside its decision. Preserve a sensible reading order on a smaller screen. Keep text legible, captions meaningful and important instructions available without relying on an image alone.
When using video, describe what it demonstrates and what the learner should do with it. A recording of a presenter can be paired with separately prepared slides where that helps explain the material. Subtitles, cue points and appropriate slide timing can make a useful recording easier to navigate and maintain; they are not a substitute for checking its accuracy.
Design assessment and feedback deliberately
Match questions to the outcome rather than to incidental facts from the page. Use realistic choices and explain why an answer is useful or mistaken. Where a mini-quiz uses a question pool, review the coverage of the displayed subset so randomization does not accidentally omit the essential objective.
For applied work, provide the required evidence, expected scope and assessment criteria in the Assignment brief. Agree how quickly the instructor will respond and what happens when the work is not yet sufficient. Do not design a practical certification around an unowned marking queue.
Decide which results contribute to Course progress, module completion, activity completion and certification. These are related controls, not interchangeable labels. Understand Progress During Training explains the participant’s progress model and Certificates owns certificate configuration.
Create a sustainable production and review process
| Stage | Work to complete | Owner or evidence |
|---|---|---|
| Brief | Audience, outcome, format, evidence, rights and maintenance need agreed | Service owner and content specialist |
| Representative design | One complete example with realistic text, media and interaction | Designer and specialist review |
| Production | Remaining content built using the accepted pattern | Named author with controlled source assets |
| Accuracy and accessibility review | Facts, instructions, language, links, media and usable navigation checked | Qualified reviewer and recorded corrections |
| Delivery verification | Content connected to the intended Training Activity and tested by a representative participant | Completion and access evidence under the intended role |
| Maintenance handoff | Owner, source, review triggers and safe update process recorded | The operating team accepts the maintained version |
Include review effort in the production estimate. Specialist availability is often a larger constraint than page creation. Agree how feedback will be collected and resolved so the author does not receive conflicting changes from several people without a decision owner. Review a Course and Prepare It for Delivery explains the Course review process, and Create Accessible and Mobile-Friendly Learning Content provides a focused accessibility review.
Prepare the Training Activity alongside the content
Use the content in a representative Training Activity before declaring it ready. The activity may add an Event, Assignment, schedule, enrollment conditions, price or certificate. These choices affect what the Course needs to explain and how the complete journey feels to the participant.
Write the offer description for the audience’s decision: what the training helps them achieve, who it suits, what it requires and what happens after enrollment. A polished learning page cannot compensate for a confusing activity title or an unclear entry route.
If several audiences use the same maintained content, decide what should be shared and what should be a separate delivery. Avoid cloning assets merely to change an activity’s audience or schedule. Conversely, use a separate maintained version where the actual content, language or governance requires it.
Verify the first portfolio
| Scenario or check | Expected result or evidence |
|---|---|
| Audience relevance | A representative learner recognizes the task, intended benefit and prerequisites |
| Learning flow | Pages, media, practice and next actions form a coherent journey |
| Accessibility and devices | Essential content is understandable with relevant assistive and smaller-screen use; media alternatives and navigation are checked |
| Evidence | Assessment and completion behavior match the claim and the delivered activity |
| Maintenance | The team knows the source, owner, review trigger and safe update process |
| Production readiness | The accepted example and measured review capacity support a realistic plan for the remaining portfolio |
Troubleshooting
| Problem | What to check |
|---|---|
| The Course contains information but no clear learning journey | Return to the audience task and identify the explanation, example, practice and expected action needed |
| Authors repeatedly rebuild the same layout or outline | Choose an appropriate Page template for individual pages or a whole source Course for a targeted full structure |
| A quiz produces a result that does not match the intended evidence | Review the object’s scoring, question coverage, completion requirements and linked certificate criteria |
| The content looks good to an administrator but confuses learners | Test the real participant route, permissions, navigation and smaller-screen experience |
| Updates stall after launch | Assign a maintenance owner and retain editable sources and review triggers before expanding the portfolio |
FAQ
-
Should we start by turning every presentation into a Course?
Start by identifying the audience’s task and the learning outcome. Reuse a presentation where it supports that outcome, but add the context, examples, practice and evidence a self-paced learner needs. Some presentations are better retained as supporting reference or facilitated material.
-
What is the difference between a Page template and a template Course?
A Page template supplies a single page’s starting layout or guidance. The Course builder outline is created by adding and arranging pages. A whole source Course can be cloned to reuse a complete structure and targeted instructional guidance.
-
Do we need an assessment in every Course?
Choose evidence that fits the purpose. Practice questions can help learning; applied work may require instructor assessment; an acknowledgement can record a confirmation. Do not add a pass/fail test merely for uniformity or imply a page view proves practical competence.
-
When is the first portfolio ready to use?
When the required content is accurate and reviewed, the intended audience can use it, the delivery and evidence design works, and someone owns its maintenance. Verify the connected Training Activity rather than treating finished page editing as the final readiness check.