Commits

Alexander Dudko committed bfc328b

README updated. v0.1.3

Comments (0)

Files changed (2)

 Introduction
 ============
 
-I used to waste hours cloning tasks in JIRA, editing their summaries, description and etc. Step by step I came to the idea that I need a template of my frequently used tasks so that I can re-create them very easy and effortless.
-
 The key idea of jira-bulk-loader is an activity template.
 
-The template is written in human language with a few markup rules. jira-bulk-loader.py uses the prepared template to create the corresponding set of tasks in less than one minute.
+The template is written in human language with a few markup rules. jira-bulk-loader.py uses the prepared template to create the corresponding set of tasks easy and effortless.
 
 
 
     | 	h5. Second task summary \*John\*
     |	=description 194567
 
-the important difference is that you don't need to change assignee or description of each task in your template. You change variable value instead and it is applied to every line in the template. 
+the important difference is that you don't need to change assignee or description of each task in your template. You change variable value instead and it is applied to every line in the template.
+
+
+Run-time variables
+==================
+
+Sometime it is necessary to create a reference to another task in the template. Such requirement can be fulfilled with a help of template run-time variables.
+
+    |  h5. h5 task1 *assignee* [TASK_KEY1]
+    |  h5. h5 task2 *assignee* [TASK_KEY2]
+    |  h5. h5 task3 *assignee*
+    |  =description $TASK_KEY1
+    |  # Sub-task *assignee*
+    |  =description $TASK_KEY2
+
+When jira-bulk-loader creates 'h5 task1' and 'h5 task2' in Jira, $TASK_KEY1 and $TASK_KEY2 will be have their issue_id.
 
+The only restriction is: you can't reference a task that has not been created yet, i.e. template variables cannot be used before assignment.
 
 
 Issues and new ideas
 
 setup(
     name='jira-bulk-loader',
-    version='0.1.2',
+    version='0.1.3',
     packages=['jirabulkloader','jirabulkloader.test',],
     author='Alexander Dudko',
     author_email='alex.dudko@gmail.com',
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.