Scrumize

Description

Scrumize is docbook transformer task that allow to:

  • extract user stories (tagged @userstory)
  • append user stories summary as an appendix

see also:

Scrumize task parameters

|Attribute  | Description           | Value                         | Required  |
|-----------|-----------------------|-------------------------------|-----------|
|file       | input file            | <filename>.csv                | yes       |
|tofile     | output file           | <filename>.<mime>             | yes       |
|format     | output format         | markdown*|docbook             | no        |

Example

src/doc.xml

doc.xml is a docbook file that xincludes content.

<?xml version="1.0" encoding="utf-8"?>
<book xml:lang="en" xmlns:xi="http://www.w3.org/2001/XInclude">

	<title>My Project</title>
	<chapter id="userstories">
		<title>User Stories</title>
		<xi:include href="suites/Suite1.md" />
	</chapter>
			
</book>

suites/Suite1.md

First user stories suite.

First user stories suite
========================

## User story 1 @userstory

As a user, I want to search for my customers by their first and last names.

## User story 2 @userstory

As a non-administrative user, I want to modify my own schedules but not the schedules of other users.

build.xml

  • ant file:
<project name="ant4docbook" xmlns:nw="antlib:net.sourceforge.ant4docbook.taskdefs">
<target name="scrumize" description="process user stories">		
	<nw:scrumize file="src/doc.xml" tofile="src/doc.scrumized.xml" format="docbook" />
</target>
</project>