tools.md

Helpful Participation Tools

Hacker's Toolbelt

The following tools and education resources are helpful aids to bootstrap all team members relative to the deliverables required for the hackathon.

Markdown

• Markdown Tutorial
• Markdown Documentation
  • Getting Started with Markdown
  • Markdwon Basics
  • Mastering the Markdown Language
• Authoring Tools
  • Integrated development environment (IDE)
    • Visual Studio Code
    • Atom
  • Markdown Converters for Word Processors
    • MS-Word to Markdown
      • Word-to-Markdown
      • Writage
      • How to convert Word Docs to Markdown
    • Google Docs to Markdown
      • G-Suite Plugins
      • How to convert Google Docs to Markdown

UML Design Tools

Here are some recommendations for the creation of UML diagrams. These diagrams should be stored in the usecase/images/src/puml folder.

• PlantUML

  • Documentation

    • PlantUML Sequence Diagram Language
    • PlantUML Colors

  • Select your preferred UML Diagram Development tooling for the creation of .puml files and the associated generation of .png images.

    • PUML Editor

    • Local Docker based PUML Server using a single command:

      $ docker run -d -p 8080:8080 plantuml/plantuml-server:tomcat
      

Flowchart Diagrams

Here are some recommendations for the creation of flowcharts. These diagrams should be stored in the usecase/images/src/charts folder.

• Lucid Charts
• Online development using diagrams.net
• FREE Desktop Version draw.io

Slideware

Here are some recommendations for the creation of flowcharts. These diagrams should be stored in the usecase/images/src/slideware folder.

• PowerPoint
• Keynote

Visual Collaboration Boards

Design Thinking activities make use of visual collaboration tools that allow teams to work together on virtual whiteboards with a variety of features for real-time interactions.

Participants may use any tools of their choice as long as their resulting board is easily accessible by the judges. It is recommended that participants use the visual collaboration board tool offered by Mural and refer to the Mural FAQ.

Use Case Story

Successful hackathon participants will demonstrate their story-telling ability. This repository contains a structured document outline (using Markdown) to describe a solution to a problem or idea. It is recommended that participants familiarize themselves with the sample use-case story template. After completing their Design Thinking activities, participants can use their results to clearly articulate story-telling topics such as:

• Business Challenge
• Problem Domain Vernacular
• Solution Assumptions
• Problem Domain Persona

Participants should consider extending their user story with a use case using UML sequence diagrams. Please refer to UML Design Tools for assistance.