Giter Site home page Giter Site logo

rundown's Introduction

Rundown

Rundown is a concise, flexible and human readable language to describe running workouts. Running is the only sport currently supported by rundown, although a lot of what can be written in rundown can probably apply to other sports, such as cycling or swimming.

Motivation

The motivation behind rundown is to provide a universal format for presenting and sharing running workouts, that could be integrated with proprietary apps and platforms to easily create workouts ready to be synced to the watch. This would facilitate sharing between athletes / coaches / etc, who may not necessarily use the same platforms for their workouts.

By providing an easy to read, standard but also flexible format for running workouts, rundown can also provide some consistency over the titles athletes decide to give to their sessions on popular platforms such as Strava.

Key Principles

  • Human Readable : The main goal of rundown is the sharing of running workouts. Workouts should therefore be readable and intelligible, even with little to no knowledge of the rundown syntax;
  • Concise & Lightweight : Any workout should be describable in as little characters as possible without compromising readability. There is no file extension for Rundown. Where workouts need to be shared as files, it is appropriate to use the txt extension;
  • Flexible : Rundown should provide tools to allow for different ways for the same workouts to be defined, to cater for the needs of as many people as possible. While concision is an important principle, we also want to allow users to provide the level of detail they need for their training sessions.

Specifications

The specs for rundown can be found here.

Version

This is a first draft. Any feedback is welcome!

Examples

Here are a few valid rundown workout examples:

30mn steady
10 x 30", R=30"
warmup ; 5 x 1M
4 x 2km @(M-HM)P, R=2mn
10 x 800m track, S=3mn
3 x (9mn @MP; R=1:30; 5mn @10kP), R=5mn
15mn WU; 10 x 150m uphill @(160-170)bpm, R=(150m downhill @5:30mn/km); 15mn CD

rundown's People

Contributors

timotheel avatar

Stargazers

Jason Butler avatar jmcb avatar

Watchers

Dan Hamilton avatar  avatar Hossein Zeinali avatar Thibault Bertin avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.