Course Introduction
The Reproducible Evaluation Workflows with R Markdown and Quarto Training Course equips monitoring, evaluation, research, and learning professionals with practical skills for producing transparent, repeatable, and professionally presented analytical outputs. Evaluation teams frequently work with survey datasets, administrative records, indicator tracking systems, qualitative findings, statistical models, and multiple reporting requirements. When analysis is performed through disconnected scripts, manually edited spreadsheets, and copied figures, it becomes difficult to verify results, reproduce earlier reports, and understand how findings change when new information becomes available. This course introduces an integrated approach in which analytical code, methodological explanations, tables, charts, and conclusions are maintained together in executable documents that can be regenerated consistently.
The programme develops practical competence in both R Markdown and Quarto, explaining their common principles, distinctive capabilities, and appropriate applications in evaluation environments. Participants learn how to create analytical documents that combine Markdown text, executable R code, structured metadata, and dynamically generated outputs. They examine how document rendering works, how execution settings influence results, and how to separate analytical calculations from narrative interpretation. The training covers common reporting formats, including HTML, Word, and PDF, alongside presentations and other supported outputs where appropriate. Participants also learn to select document formats according to audience needs, institutional templates, accessibility requirements, technical constraints, and the intended use of the evaluation product.
A major focus is building reliable analytical workflows that begin with raw data and end with verified evaluation findings. Participants learn to structure project folders, import data systematically, document cleaning decisions, define reusable analytical functions, calculate indicators, generate descriptive statistics, and produce consistent visualisations. They practise embedding code chunks that execute in a controlled order and generate tables and figures directly from the underlying data. The course also addresses missing values, data validation, unexpected input changes, and common coding errors that can undermine reporting reliability. By replacing manual copying and pasting with code-driven outputs, participants can reduce avoidable inconsistencies and establish clearer links between source data, analytical methods, reported statistics, and management conclusions.
The course places particular emphasis on report parameterisation, reusable templates, and automated reporting for organisations managing multiple programmes, projects, locations, indicators, or reporting periods. Participants learn how to use document parameters to generate tailored outputs from a common reporting template, reducing the need to maintain separate versions of similar reports. They explore how to organise reusable code, standardise presentation elements, manage references, control tables and figures, and produce audience-specific documents from validated analytical results. Practical exercises demonstrate how the same analytical workflow can support monthly monitoring summaries, quarterly performance reviews, donor reports, baseline and endline analyses, evaluation briefs, and portfolio-level dashboards while retaining appropriate distinctions between programme contexts and indicator definitions.
Another core component addresses reproducibility beyond the reporting document itself. Participants examine package management, dependency recording, project isolation, version control with Git, data provenance, testing, and workflow automation. They learn why a report that renders successfully on one computer may fail elsewhere because of differences in software versions, package availability, file paths, fonts, external resources, or hidden manual steps. The training introduces procedures for documenting computational environments, validating source files, checking rendered outputs, and maintaining version histories that make analytical changes traceable. Participants also examine how to handle confidential datasets, protect sensitive information, avoid embedding personal information in published reports, and share code and documentation without inadvertently exposing restricted data.
The programme concludes with a practical capstone project in which participants build a reproducible evaluation report from a prepared dataset through to a finished analytical publication. The project incorporates data preparation, indicator calculation, statistical analysis, tables, charts, interpretation, references, quality checks, and export to suitable output formats. Participants assess their reports against criteria for correctness, clarity, reproducibility, accessibility, maintainability, and governance. They also prepare an implementation roadmap for integrating reproducible documents into existing monitoring and evaluation processes, identifying training needs, review responsibilities, standard templates, software requirements, and publication procedures. By the end of the course, participants will be able to produce evaluation outputs that are easier to update, independently verify, share responsibly, and maintain over the life of a programme.
Duration
10 days
Who Should Attend
-
Monitoring, evaluation, accountability, and learning specialists responsible for producing recurring programme performance reports and evaluation deliverables.
-
Evaluation officers who analyse quantitative data and need transparent, reproducible methods for calculating indicators and presenting findings.
-
Research analysts and statisticians who want to integrate analytical code, methodological explanations, tables, and visualisations into one workflow.
-
Data analysts and data scientists using R to produce reports for programme managers, technical teams, donors, and institutional leadership.
-
Programme monitoring officers responsible for monthly, quarterly, annual, and end-of-project performance reporting.
-
Evaluation consultants preparing baseline studies, midterm reviews, endline evaluations, impact assessments, and evidence synthesis reports.
-
Public-sector monitoring and planning professionals producing evidence-based performance reports and policy analysis.
-
Development practitioners managing multiple projects, indicators, locations, implementing partners, and reporting schedules.
-
Academic researchers and postgraduate students preparing reproducible research reports, dissertations, and evaluation publications.
-
Information management specialists responsible for analytical documentation, standard reporting templates, and knowledge repositories.
-
Data quality and assurance officers who need to trace reported figures to their source data and analytical procedures.
-
Statistical programmers seeking better project organisation, reusable reporting components, and automated document generation.
-
Programme managers and technical advisers who commission analytical reports and need to review the transparency of methods and findings.
-
Institutional learning teams seeking to standardise analytical workflows and improve collaboration between analysts and report reviewers.
-
Digital transformation and research technology professionals supporting reproducible analytical systems and automated reporting infrastructure.
Course Objectives
-
Explain the principles of computational reproducibility and demonstrate how executable documents strengthen the transparency, consistency, and auditability of evaluation findings.
-
Create and manage R Markdown and Quarto documents that integrate narrative text, analytical code, tables, figures, references, and dynamically generated results.
-
Organise evaluation projects using clear directory structures, consistent file naming, modular scripts, data documentation, and maintainable analytical components.
-
Import, clean, validate, and transform evaluation datasets through documented code that minimises manual intervention and preserves the traceability of data preparation decisions.
-
Develop executable analytical workflows that calculate indicators, conduct statistical analysis, generate visualisations, and update findings automatically when valid source data change.
-
Configure document metadata, execution options, code chunk behaviour, output formats, table of contents, cross-references, and presentation settings for professional reporting.
-
Apply parameters and reusable templates to generate consistent programme reports across different projects, locations, reporting periods, and indicator groups.
-
Manage R package dependencies, computational environments, file paths, and software requirements to improve the reliability of reports across different computers and users.
-
Use Git and version control practices to track analytical changes, collaborate with reviewers, preserve previous versions, and document the development of evaluation outputs.
-
Implement testing, validation, error handling, and rendered-document quality checks to detect incorrect calculations, broken references, missing outputs, and unexpected changes.
-
Apply responsible data governance, confidentiality, accessibility, and publication controls when generating and distributing reproducible evaluation reports.
-
Deliver a complete reproducible evaluation report with verified analytical outputs, clear interpretation, documented dependencies, and an implementation plan for organisational adoption.
Comprehensive Course Outline
Module 1: Foundations of Reproducible Evaluation Workflows
-
Explain computational reproducibility, analytical transparency, replicability, and auditability, distinguishing their roles in credible evaluation research and organisational reporting.
-
Identify common sources of inconsistency in evaluation reporting, including manual spreadsheet edits, copied charts, undocumented transformations, and unrecorded analytical decisions.
-
Map the workflow from source data and data cleaning through statistical analysis, visualisation, interpretation, document generation, and publication.
-
Develop reproducibility criteria for evaluation deliverables, including data provenance, code availability, documented dependencies, validated outputs, and clear methodological explanations.
Module 2: R Markdown and Quarto Fundamentals
-
Examine the architecture and purpose of R Markdown and Quarto, including Markdown syntax, executable code cells, document metadata, rendering, and output generation.
-
Create basic documents containing headings, paragraphs, lists, tables, links, mathematical notation, and embedded R code for evaluation reporting.
-
Compare YAML configuration, document options, execution settings, and output-format declarations across R Markdown and Quarto workflows.
-
Select the appropriate authoring framework by considering existing organisational systems, project requirements, output formats, language support, and long-term maintenance.
Module 3: Project Setup and Reproducible File Organisation
-
Establish a structured project directory separating source data, processed data, analysis scripts, reusable functions, report files, figures, tables, and supporting documentation.
-
Apply consistent file naming, relative paths, configuration settings, and project-root conventions to reduce dependency on individual computers and working directories.
-
Develop a README file and project metadata that explain the purpose of the analysis, input requirements, execution instructions, expected outputs, and responsible contacts.
-
Establish procedures for managing temporary files, generated outputs, restricted data, archived materials, and project-specific configuration without creating unnecessary duplication.
Module 4: Data Import, Cleaning, and Validation
-
Import CSV files, spreadsheets, database extracts, and other supported data sources using documented R code and consistent data-type specifications.
-
Implement data-cleaning procedures for missing values, duplicate records, inconsistent categories, invalid dates, unexpected codes, and changes in source-data structure.
-
Create validation checks for required fields, plausible ranges, unique identifiers, record counts, indicator denominators, and consistency between related variables.
-
Document data preparation decisions and create clear distinctions between raw source files, intermediate datasets, and approved analytical data used in evaluation reporting.
Module 5: Executable Code Chunks and Document Rendering
-
Configure code chunks and executable cells to control execution, displayed code, printed output, warnings, messages, figures, and other content included in rendered documents.
-
Understand dependency ordering and the relationship between document execution, object creation, cached results, and the successful generation of analytical outputs.
-
Diagnose common rendering failures caused by missing packages, undefined objects, incorrect paths, incompatible software, malformed metadata, and unexpected input data.
-
Establish a clean-rendering procedure that verifies the report can be generated from a fresh session rather than relying on hidden objects or interactive workspace state.
Module 6: Statistical Analysis and Indicator Calculation
-
Embed descriptive statistics, frequency distributions, cross-tabulations, confidence intervals, and other appropriate analytical procedures within reproducible evaluation documents.
-
Develop reusable functions for indicator calculations, denominator definitions, disaggregation, target comparisons, and reporting-period summaries.
-
Integrate suitable regression, time-series, survey, or other statistical methods where required, documenting assumptions and limitations in the resulting report.
-
Separate computational results from interpretation so that narrative conclusions are grounded in verified outputs and remain appropriately qualified when evidence is uncertain.
Module 7: Tables, Visualisations, and Analytical Presentation
-
Generate data-driven tables that display indicator results, programme comparisons, disaggregated findings, descriptive statistics, and evaluation evidence with consistent formatting.
-
Create reproducible charts using suitable R visualisation tools, including time-series graphs, bar charts, distributions, and comparisons of observed results against targets.
-
Apply consistent labels, units, captions, source notes, legends, colour choices, and accessible visual conventions to improve interpretation across report formats.
-
Validate figures and tables against underlying analytical data, checking aggregation levels, missing categories, scale choices, rounding, and consistency with reported conclusions.
Module 8: Document Design and Multiple Output Formats
-
Configure Quarto and R Markdown documents to produce suitable HTML, Word, and PDF outputs, subject to the capabilities and dependencies of the selected format.
-
Apply document metadata, themes, templates, typography, margins, page layout, headers, footers, and other presentation settings for professional evaluation deliverables.
-
Create navigable reports using table of contents settings, numbered sections, cross-references, figure captions, table captions, and appropriately structured appendices.
-
Review rendered documents for pagination problems, broken links, code leakage, clipped tables, unreadable figures, and formatting differences across output formats.
Module 9: Parameterised Reports and Reusable Templates
-
Design parameterised documents that accept project names, geographic areas, reporting periods, indicator selections, and other approved inputs without duplicating analytical code.
-
Generate tailored reports for multiple projects or locations from a common template while preserving the distinct definitions, denominators, and contexts required by each programme.
-
Build reusable report components, shared functions, configuration files, and template elements that standardise recurring analytical tasks across teams.
-
Validate parameter combinations and implement clear error messages, input checks, and documented restrictions that prevent invalid or misleading report generation.
Module 10: Advanced Quarto Publishing and Project Features
-
Organise Quarto projects using configuration files, shared resources, reusable content, and suitable execution settings for larger evaluation reporting assignments.
-
Develop multi-document reports, analytical websites, presentations, and other supported publication outputs where they match stakeholder communication requirements.
-
Use cross-references, citations, bibliographies, equations, callouts, and document navigation features to strengthen analytical communication and evidence traceability.
-
Establish publishing procedures that distinguish internal analytical drafts from approved outputs and ensure that generated publications contain only authorised information.
Module 11: Reproducible Environments and Dependency Management
-
Identify how R versions, package versions, system libraries, fonts, rendering engines, and external resources can affect the reproducibility of analytical reports.
-
Record project dependencies and use appropriate package-management tools, such as renv, to restore a documented R package environment when needed.
-
Apply consistent installation and setup instructions that allow another analyst to prepare the software environment and rerun the evaluation workflow.
-
Document known environment limitations and test report generation across suitable machines or controlled execution environments before relying on the workflow for recurring production.
Module 12: Git, Version Control, and Collaborative Reporting
-
Establish Git repositories for evaluation projects and learn to track changes to report files, scripts, configuration, documentation, and other suitable text-based materials.
-
Use commits, branches, comparisons, and review procedures to document analytical changes and preserve the history of report development and methodological decisions.
-
Coordinate collaborative work through pull requests or equivalent review processes, resolving conflicting edits and maintaining clear responsibilities for analysis and approval.
-
Apply suitable data-versioning and repository policies, recognising that sensitive datasets and large binary files may require separate controlled storage rather than ordinary source-code version control.
Module 13: Testing, Quality Assurance, and Error Handling
-
Develop automated checks for data assumptions, indicator calculations, expected record counts, required variables, statistical outputs, and report-generation prerequisites.
-
Use suitable R testing tools and workflow checks to identify incorrect functions, broken dependencies, unexpected changes, and errors introduced during code revisions.
-
Implement warning management, informative error messages, validation logs, and controlled failure procedures so that incomplete or invalid reports are not mistaken for approved outputs.
-
Conduct final document reviews that compare rendered figures and tables with expected results, verify citations and references, and confirm that all required sections have been generated.
Module 14: Workflow Automation and Scheduled Reporting
-
Design repeatable execution procedures that run data preparation, analytical scripts, document rendering, and validation in a predictable sequence.
-
Explore appropriate automation options, including command-line rendering, scheduled jobs, task runners, and continuous integration services where organisational infrastructure supports them.
-
Implement logging, status checks, failure notifications, and controlled output destinations to improve the reliability of monthly, quarterly, and annual evaluation reporting.
-
Establish approval gates and publication controls so automated workflows produce review-ready outputs without bypassing technical validation or authorised sign-off.
Module 15: Data Governance, Accessibility, and Responsible Publication
-
Apply data minimisation, access controls, de-identification, and appropriate storage practices to protect confidential beneficiary information and sensitive programme records.
-
Separate public reporting outputs from internal analytical materials and prevent restricted data, credentials, private file paths, or sensitive metadata from being exposed during rendering.
-
Improve report accessibility through meaningful headings, descriptive captions, readable charts, appropriate document structure, and accessible output-format choices.
-
Document analytical limitations, data sources, transformation decisions, software dependencies, and responsible review procedures to support ethical use and informed interpretation of findings.
Module 16: Capstone Project and Institutional Implementation
-
Develop a complete reproducible evaluation project using a prepared dataset, a defined analytical question, documented assumptions, and clearly specified reporting requirements.
-
Build an executable report that imports and validates data, calculates indicators, generates tables and charts, interprets findings, and renders into agreed output formats.
-
Demonstrate reproducibility by executing the project in a clean environment, reviewing dependency records, testing key calculations, and resolving rendering or data-quality errors.
-
Present a final implementation package containing the project structure, source code, rendered report, quality-assurance checklist, documentation, and recommendations for organisational adoption.
Training Approach
This course will be delivered by our skilled trainers who have vast knowledge and experience as expert professionals in the fields. The course is taught in English and through a mix of theory, practical activities, group discussion and case studies. Course manuals and additional training materials will be provided to the participants upon completion of the training.
Tailor-Made Course
This course can also be tailor-made to meet organization requirement. For further inquiries, please contact us on: Email: training@upskilldevelopment.com Tel: +254 721 331 808
Training Venue
The training will be held at our Upskill Training Centre. We also offer training for a group (at a discount of 10% to 50%) at requested location all over the world. The Onsite course fee covers the course tuition, training materials, two break refreshments, buffet lunch, airport transfers, Upskill gift package, and guided tour.
Visa application, travel expenses, dinners, accommodation, insurance, and other personal expenses are catered by the participant
Certification
Participants will be issued with Upskill certificate upon completion of this course.
Airport Pickup and Accommodation
Airport pickup and accommodation is arranged upon request. For booking contact our Training Coordinator through Email: training@upskilldevelopment.com, +254 721 331 808
Terms of Payment:
Unless otherwise agreed between the two parties’ payment of the course fee should be done 3 working days before commencement of the training so as to enable us to prepare better.








