Course Introduction
Reproducible research is essential for producing credible, transparent, and verifiable evidence in scientific research, monitoring and evaluation, policy analysis, and development programming. As analytical projects become more complex and teams work across multiple locations, maintaining consistency between data, code, analysis, and published reports becomes increasingly challenging. This course introduces participants to structured research workflows that make analytical processes easier to inspect, repeat, validate, update, and share. By combining Quarto publishing with Git version control, participants will learn how to organize research projects so that findings can be regenerated and reviewed without depending on undocumented manual procedures or individual researchers’ personal workspaces.
Quarto provides a flexible publishing environment for combining narrative text, executable code, analytical outputs, visualizations, and references in a single source document. It supports the production of reports, research papers, presentations, dashboards, and other analytical outputs from reusable project files. Participants will explore how to structure Quarto documents, configure execution options, manage document metadata, incorporate code from supported programming languages, and render consistent outputs in formats such as HTML, PDF, and Word. The course emphasizes practical techniques for separating analytical content from presentation, reducing repetitive reporting work, and maintaining a clear connection between source code, results, and published research products.
Git provides the version control foundation for tracking changes to source files, reviewing contributions, maintaining project history, and coordinating work among researchers and analysts. Participants will learn the core concepts of repositories, commits, branches, merges, remotes, and collaboration workflows. They will practice recording meaningful changes, comparing document versions, recovering previous work, resolving merge conflicts, and collaborating through shared repositories. Particular attention will be given to using Git effectively with Quarto projects, including the management of source documents, supporting scripts, configuration files, reference libraries, and project documentation while avoiding the unnecessary storage of large or sensitive generated files.
The course also examines how reproducibility depends on disciplined project organization, dependency management, data documentation, consistent execution environments, and transparent analytical decisions. Participants will learn to establish clear folder structures, document data sources, define project-level settings, and manage software packages and supporting resources. They will explore strategies for handling data imports, intermediate files, rendered outputs, bibliographies, citations, and computational dependencies. Practical exercises will demonstrate how to reduce common sources of inconsistency, including hard-coded file paths, undocumented manual edits, missing packages, untracked changes, and analyses that cannot be regenerated reliably on another computer.
Collaboration and quality assurance are central to the development of trustworthy research outputs. Participants will learn how to review analytical changes, document assumptions, organize feedback, validate rendered reports, and establish repeatable checks before publication. The training will introduce collaborative repository practices, including clear commit messages, branch-based development, pull or merge requests, code review, issue tracking, and automated checks where appropriate. Participants will also examine ethical and security considerations when sharing research repositories, particularly when projects contain confidential participant information, restricted datasets, unpublished findings, or credentials. These practices help research teams improve accountability while protecting sensitive information and maintaining responsible access controls.
By the end of the course, participants will be able to develop a practical research project that combines Quarto documents, analytical code, structured data references, Git history, and clear project documentation. They will understand how to regenerate outputs, track changes, collaborate with colleagues, and publish reports through a more transparent and maintainable workflow. The training is suitable for researchers, statisticians, monitoring and evaluation specialists, policy analysts, data scientists, and technical professionals who need to improve the reliability of analytical deliverables. Participants will leave with reusable templates, practical workflow patterns, and a foundation for embedding reproducibility into their everyday research and reporting processes.
Duration
5 days
Who Should Attend
-
Research officers and scientific researchers preparing reproducible studies, technical papers, and analytical publications.
-
Monitoring, evaluation, accountability, and learning professionals producing repeatable evidence reports and programme assessments.
-
Data analysts and statisticians who need to track analytical changes and regenerate results consistently.
-
Data scientists developing code-driven reports, research outputs, and collaborative analytical projects.
-
Policy analysts preparing evidence briefs, policy papers, and quantitative or qualitative research reports.
-
Academic lecturers, postgraduate researchers, and research assistants managing collaborative research projects.
-
Public sector analysts responsible for producing transparent, auditable, and regularly updated analytical outputs.
-
NGO and development programme specialists preparing donor reports, evaluation findings, and evidence-based recommendations.
-
Research team leaders responsible for improving project documentation, quality assurance, and collaboration practices.
-
Software developers and technical specialists supporting research computing and analytical publication workflows.
-
Economists and social scientists working with statistical models, survey data, and reproducible reporting pipelines.
-
GIS and environmental analysts producing code-based research reports, visualizations, and technical documentation.
-
Public health researchers and epidemiologists documenting analytical methods and reporting study findings.
-
Consultants and technical advisers delivering repeatable analytical products to clients and institutional partners.
-
Professionals with basic programming or data analysis experience who want to adopt Quarto and Git in their research workflows.
Course Objectives
By the end of this training course, participants will be able to:
-
Explain the principles of reproducible research and establish workflows that make analytical methods, data transformations, computational steps, and research outputs transparent and verifiable.
-
Create, configure, and render Quarto documents that combine narrative explanations, executable code, tables, visualizations, citations, and analytical results in a unified publishing workflow.
-
Apply Git fundamentals, including repository initialization, staging, committing, branching, merging, and remote synchronization, to maintain reliable histories of research project changes.
-
Integrate Quarto and Git to track source documents, analytical scripts, configuration files, and supporting documentation while maintaining a clear distinction between source materials and generated outputs.
-
Organize research projects using consistent directory structures, relative file paths, reusable components, metadata, and project-level settings that support portability and maintainability.
-
Manage references, bibliographies, software dependencies, data documentation, and execution settings to reduce inconsistencies and improve the ability to regenerate research outputs.
-
Collaborate effectively through shared repositories, branches, code reviews, pull or merge requests, issue tracking, and systematic resolution of conflicting changes.
-
Implement quality assurance practices that validate document rendering, analytical outputs, links, citations, and project completeness before research products are shared or published.
-
Apply responsible data management and security practices when versioning research projects, including excluding confidential datasets, credentials, and unnecessary generated files from shared repositories.
-
Develop and document a complete reproducible research workflow that can be regenerated, reviewed, maintained, and adapted for future research, evaluation, or policy reporting assignments.
Comprehensive Course Outline
Module 1: Foundations of Reproducible Research
-
Understanding reproducibility, replicability, transparency, computational provenance, and their importance in scientific and development research.
-
Identifying common sources of analytical inconsistency, including undocumented transformations, manual report edits, software differences, and missing dependencies.
-
Examining the relationship between research questions, data preparation, analytical code, results, documentation, and publication-ready outputs.
-
Designing a reproducible workflow with clear project responsibilities, documented decisions, repeatable execution steps, and verifiable research products.
Module 2: Quarto Fundamentals and Document Authoring
-
Installing and configuring Quarto alongside suitable editors and supported programming environments for research document creation and publishing.
-
Creating Quarto documents with YAML metadata, Markdown content, code cells, execution options, captions, tables, and structured sections.
-
Combining narrative explanations with executable R, Python, or other supported code to connect analytical procedures directly to research findings.
-
Rendering Quarto documents into HTML, PDF, and Word formats while understanding format requirements, rendering dependencies, and output configuration.
Module 3: Advanced Quarto Publishing and Project Organization
-
Structuring multi-document Quarto projects with shared configuration, reusable content, navigation, cross-references, and consistent formatting.
-
Customizing tables, figures, code visibility, output styling, citations, bibliographies, and document metadata for different research audiences.
-
Building research websites, technical reports, presentations, and organized publication collections using appropriate Quarto project types.
-
Troubleshooting rendering errors, missing resources, broken references, execution failures, and format-specific problems through systematic diagnostics.
Module 4: Git Fundamentals and Version Control
-
Understanding repositories, working directories, staging areas, commits, branches, remotes, and the role of version control in research integrity.
-
Initializing repositories and tracking Quarto source documents, analytical scripts, configuration files, project instructions, and supporting documentation.
-
Creating meaningful commits, reviewing change histories, comparing revisions, inspecting differences, and recovering earlier versions of research files.
-
Configuring Git identity and repository settings while applying practical conventions for commit messages, file organization, and change documentation.
Module 5: Integrating Git with Quarto Research Projects
-
Establishing Git repositories for Quarto projects and selecting appropriate files to track, regenerate, exclude, or maintain separately.
-
Configuring
.gitignorerules for temporary files, rendered outputs, caches, local settings, sensitive files, and other unnecessary repository content. -
Managing changes to YAML configuration, Markdown content, code cells, bibliographies, figures, and supporting resources through version-controlled workflows.
-
Regenerating reports from committed source files and using Git history to trace how analytical methods, interpretations, and reported results have changed.
Module 6: Data, Dependencies, and Computational Reproducibility
-
Organizing raw, intermediate, and derived data with clear naming conventions, documentation, provenance records, and appropriate access restrictions.
-
Using relative file paths and portable project structures to reduce dependence on individual computers, user directories, and machine-specific configurations.
-
Recording software versions, package dependencies, environment requirements, and execution settings to improve consistency across research environments.
-
Diagnosing differences in analytical outputs caused by missing packages, changed datasets, random seeds, operating system differences, or incompatible software versions.
Module 7: Collaborative Research with Git Repositories
-
Connecting local research projects to remote repositories and synchronizing changes with appropriate push, pull, fetch, and clone operations.
-
Using branches to develop new analyses, revise reports, test improvements, and maintain a stable version of the main research project.
-
Resolving merge conflicts in Markdown, code, configuration files, and bibliographies while protecting analytical logic and document consistency.
-
Applying pull or merge requests, code reviews, issue tracking, and collaborative documentation to improve team communication and analytical quality.
Module 8: Automation, Testing, and Quality Assurance
-
Establishing repeatable rendering procedures and documented commands that allow research reports to be regenerated with minimal manual intervention.
-
Checking source files, code execution, references, links, tables, figures, and output completeness before delivering or publishing research products.
-
Introducing suitable automated workflows through continuous integration services to render documents, run tests, and detect selected errors when repository changes occur.
-
Developing quality assurance checklists and review procedures that connect analytical validity, reproducibility, document presentation, and publication requirements.
Module 9: Publishing, Sharing, and Responsible Research Management
-
Publishing Quarto outputs through appropriate channels, including document distribution, static websites, and supported repository-based publication workflows.
-
Preparing clear project documentation with README files, setup instructions, dependency details, data descriptions, licensing information, and reproduction guidance.
-
Applying data protection, confidentiality, access control, and credential management practices when collaborating on restricted or sensitive research projects.
-
Selecting appropriate strategies for sharing code and research materials while respecting data licenses, intellectual property, consent requirements, and institutional policies.
Module 10: Applied Reproducible Research Workflow Project
-
Developing a complete Quarto research project that integrates analytical code, explanatory narrative, figures, tables, references, and reproducible report generation.
-
Creating a Git repository with a meaningful commit history, appropriate branching practices, clear documentation, and suitable rules for excluding unnecessary files.
-
Testing the workflow by regenerating outputs, reviewing changes, validating dependencies, and resolving representative problems affecting project portability.
-
Presenting a final reproducible research deliverable with setup instructions, version-controlled source files, quality assurance evidence, and recommendations for ongoing maintenance.
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.








