Demo Documentation Template - utwente-interaction-lab/interaction-lab GitHub Wiki

How to document a demo for a student/PHD project

Below is the standard format for how students and professors should document their project to be used in demo's, for teaching or self-learning. The language currently used is Markdown, though this is subject to change. (_file.md _)

To get started

  • Create a new Repository in Interaction Lab Github, using the project name as the Repository name
  • Select a template: utwente-interaction-lab/Project-Documentation-Template for the markdown template files for project documentation

Note: You may have to wait for access to be granted before you can create a new repository

An example of the demo documentation template

Interaction Lab Logo

Title of Demo

Version/Date:

Overview

Briefly describe the device or project and its purpose.

Setup

Provide step-by-step instructions for setting up the device or project for a demo.

  1. Step 1
  2. Step 2
  3. Step 3
    • Additional notes or sub-steps if necessary

Usage

Explain how to use the device or project during the demo.

  1. Step 1
  2. Step 2
  3. Step 3
    • Additional notes or sub-steps if necessary

Troubleshooting

List common issues and their solutions related to the demo.

  • Issue 1: Briefly describe the issue.
    • Solution: Explain the solution.
  • Issue 2: Briefly describe the issue.
    • Solution: Explain the solution.

Link to detailed documentation

Credits

⚠️ **GitHub.com Fallback** ⚠️