you-R-here

An agile iteration demo helper

you-R-here helps agile iteration demos suck less.

Current Features

• Integration with JIRA Agile
• Integration with Target Process
• Allow viewers to "follow along", showing the current user story/bug being demonstrated in real-time

Roadmap/Wishlist

• More plugins! We would love to add any of the following:
  • TFS
  • Github issues
  • Huboard
  • Trello
  • Your great idea goes here!
• WebRTC - Webcam/audio support
• Multi-tenant
• Better dashboard info
• Your great idea goes here!

Getting started with you-R-here

Clone the repo and install the packages

git clone https://github.com/racingcow/you-R-here.git
cd you-R-here
npm install

app.config.js

app.config.js is required to configure the server.

Create app.config.js in the you-R-here root folder. Make a copy of the example file and season to taste.

cp app.config.example.js app.config.js

Example app.config.js:

app = {
	title: "You-R-Here",
	serverAddress: "http://localhost",
	serverPort: 8080,
	plugin: "targetprocess"
};
exports.app = app;

NOTE, you can only select one plugin and run it in the application. In the app.js config, if you want to use Jira, set the plugin: "jira"

Also we are not using targetprocess anymore.

List of Available Plugins

jira.config.js

jira.config.js provides required configuration for the TargetProcess plugin.

Create jira.config.js in the you-R-here plugins folder. Make a copy of the example file and season to taste.

cp jira.config.example.js jira.config.js

The status id values for doneStatus and inProgressStatus are found here: https://criticaltech.atlassian.net/rest/api/2/status

Example jira.config.js:

info = {
	username: "myusername",
	password: "mysecretpassword",
	orgName: "My Company",
	jiraBoardId: 1,
	host: "mycompany.atlassian.net",
	doneStatus: [5,6],
	inProgressStatus: [3],
	demoLabels: ['demo','demonstrable'],
	numSprints: 5,
	maxResults: 150
};
exports.info = info;

targetprocess.config.js

targetprocess.config.js provides required configuration for the TargetProcess plugin.

Create targetprocess.config.js in the you-R-here plugins folder. Make a copy of the example file and season to taste.

cp targetprocess.config.example.js targetprocess.config.js

Example targetprocess.config.js:

info = {
	username: "myusername",
	password: "mysecretpassword",
	host: "mycompany.tpondemand.com", // v. 0.3.11 host replaces url 
	orgName: "My Company", // v. 0.1.3
	format: "json",
	hostUrl: "https://mycompany.tpondemand.com", // v. 0.2.1 baseImageUrl --> hostUrl
	iterationSentinel: '\'My Project Name\'', // project name to use for list of iterations
	numIterations: 5 // number of iterations to display
};
exports.info = info;

Using you-R-Here

Launch you-R-here

Launch you-R-here to enjoy running your iteration demo!

[sudo] node you-R-here.js

Organizer - http://you-R-here-server/organizer

• Enter your email address
  • we use your email address for Gravatar
• Choose last day of iteration
• Order the list of items
• Select current item
• Click `Shown' after an item has been demonstrated
• Click 'No Demo' for any item you will not be demonstrating

Presenter - http://you-R-here-server/presenter

• Enter your email address
  • we use your email address to filter the items assigned to you and for Gravatar
• current item - shows the item currently being demonstrated
• (default) all items - shows all items in this iteration demo
• my items - shows items assigned to you

Spectator - http://you-R-here-server/

• Enter your email address
  • we use your address for Gravatar (and uniqueness)
• (default) current item - shows the item currently being demonstrated
• all items - shows all items in this iteration demo

Contributing to you-R-here

• Open an issue
• Submit a pull request
• Your great idea goes here!