Skip to content

Latest commit

 

History

History
429 lines (244 loc) · 35.5 KB

README.md

File metadata and controls

429 lines (244 loc) · 35.5 KB

rallytree

Automation of Rally work-item tree management.

Introduction

RallyTree automates some operations on trees of work items in Rally.

Features

RallyTree can perform these operations on a tree:

Tree-copy creation

This operation copies a tree. You designate an existing user story or feature as the parent of the root user story of the new tree. That parent, if a user story, must not have any tasks and must not be in the tree that you are copying. User stories, optionally with their tasks and/or test cases, are copied, but not defects. In a copy of a user story, task, or test case, the name, rank, and description are copied from the original; you can choose whether the owner is copied from the original or is set to a particular user; you can choose whether the project affiliation is copied from the designated parent of the root of the tree copy or is set to a particular project; and you can specify a release, an iteration, and/or a schedule state. Test-case Risk and Priority values are also copied. Finally, you can specify custom properties of user stories and of test cases to make RallyTree copy those properties from the originals.

Scoring

This operation tallies the passing and failing results of the last runs of all the test cases, and the counts of defects, major defects, and minor defects, in a tree. It also reports a score, based on the risks and priorities of the passed and failed test cases. You can set the minimum and maximum risk and priority weights in the score. Between those limits, risk and priority increments are uniform. For example, the risk levels are “None”, “Low”, “Medium”, and “High”. If you set the risk limits to 1 and 7, then the risk levels are weighed 1, 3, 5, and 7, respectively. The weight of a test case is the sum of its risk weight and its priority weight. The score is the sum of the passing test cases’ weights, as a percentage of the sum of the passing and failing test cases’ weights.

Owner change

This operation ensures that each user story, each task, and each test case in a tree has the desired owner. You can choose whether to become the new owner or instead to specify another user as the new owner.

Project change

This operation ensures that each user story and each test case in a tree belongs to the desired project. Changing the project of a user story also makes its tasks and test cases belong to the same project, but the projects of test cases can be changed to differ from those of their user stories. This operation makes test cases belong to the specified project even when their user stories already do. Each project has project-specific sets of releases and iterations. When specifying a project, you may also specify a release and/or an iteration.

Schedule-state change

This operation assigns one of five schedule states to each user story without child user stories or tasks, and one of three states to each task. If you choose “Needs Definition” or “Accepted”, tasks are made “Defined” or “Completed”, respectively.

Task creation

This operation adds tasks to each user story with no child user stories in a tree (hereafter, “leaf user stories”). You can choose how many tasks to add to each user story and give a name to each task.

Test-case creation

This operation adds test cases to user stories. Generally, each such user story acquires one test case, to which it gives its name, description, and owner. However, the counts and names of test cases can be customized. You choose whether all user stories, or only leaf user stories (those without child user stories), will receive test cases. You can also specify a test folder, a test set, and/or a project that the test cases will all belong to.

Test-case grouping

This operation makes all test cases in a tree belong to a test folder and/or a test set.

Pass creation

This operation creates passing results for all test cases of user stories in a tree, except for test cases that already have results or that have no owner. If a test case is in any test sets, the result is defined as belonging to the first of those test sets. You must specify a build (as Rally requires) and may specify a note, to be applied to all of the new results. Whoever is the owner of the test case is defined as the tester of the result.

Planification

This operation creates a test plan (a tree of test folders and test cases) that mirrors a tree of user stories and test cases. You choose whether the test cases in the test plan are the same ones as in the user-story tree or are copied from them. If the existing test cases are used, any test-folder affiliations are replaced by the new test folders, but otherwise the test cases are not changed. If the test cases are copied, each copy acquires its name, description, rank, owner, project, risk, and priority from its original, but any test-set affiliation and results are removed in the copy.

Documentation

This operation produces a JSON representation of a tree of user stories.

Copied properties

Custom properties for user stories and test cases can be specified in a custom.js file inside a data directory within the application directory. In that file, you can specify custom properties as follows:

exports.storyProps = [
  'c_CustomPropA',
  'c_CustomPropB'
];
exports.caseProps = [
  'c_ThisProp',
  'c_ThatProp'
];

The value of properties that are specified in this manner will be copied when you copy a tree.

Parents

In RallyTree, the root of a tree is always a user story. When you copy a tree, you create a new tree, with a user story as its root. You must specify a parent for it, which may be either another user story or a feature.

Technically, when you specify a parent you are actually specifying either the Parent property (which must be a user story) or the PortfolioItem property (which must be a feature) of the root. If it has one of these properties, it cannot have the other. Confusingly, the Rally web UI labels both of these properties as “Parent”.

However, a user story can also have a Feature property. If you specify a feature as the PortfolioItem property of a user story, then that feature also becomes its Feature property, and you cannot change that. If instead you specify user story P as the Parent property of user story C, then the Feature property of C becomes any ancestor feature that C may have.

Projects

Rally forces tasks to belong to whatever project their user stories belong to.

When you change the project of a user story in Rally, Rally also propagates that change to any test cases of the user story. But Rally does not require the test cases to remain in that project. Their projects can be changed, making them differ from those of their user stories. If you request a project change with RallyTree, the user-story projects are changed whenever they are not yet the specified project. This could leave test cases of unchanged user stories in the wrong project. So, to ensure that test-case projects conform, RallyTree checks test cases, too, and changes them when they are not yet the specified project.

Releases and iterations

In Rally, some user stories and all tasks have release and iteration properties. The rules governing these properties are somewhat complex.

  • Nonleaf user stories do not have these properties.

  • Tasks inherit these properties from the user stories they belong to.

  • Only leaf user stories can have tasks. Since tasks belong only to leaf user stories, tasks always have user stories to inherit releases and iterations from.

  • Releases and iterations are project-specific, not global. Two projects need not have a release or iteration with the same name. Even if they do, those releases or iterations may or may not cover the same time period.

  • If you change the project of a user story that has a non-null release and/or iteration, Rally also changes the release and/or iteration of that user story, in accord with two rules:

    • If the new project has a release or iteration with the same name as the existing one, even if it covers a different time period, it becomes the new release or iteration (hereafter, “the homonym rule”).
    • Otherwise, the release or iteration becomes null.

With RallyTree, when you change the project of a tree, you also choose a new release and a new iteration. You can choose any release and any iteration from those of the new project, or you can make either or both of them null. RallyTree does not implement the homonym rule.

When you copy a tree, all work items in the copy belong to the same project, regardless of what projects the original work items belong to. The new project is, by default, the project of the designated copy parent. You can specify an alternative project. If you specify a release or an iteration for the copy, RallyTree checks to ensure that the release or iteration exists in the new project.

Schedule states and states

In Rally, all user stories have schedule states, and all tasks have states. They are related by somewhat complex rules.

  • There are 5 schedule states: Needs Definition, Defined, In-Progress, Completed, and Accepted.
  • There are 3 states: Defined, In-Progress, and Completed.
  • Nonleaf user stories have purely derivative schedule states. You cannot set them. Rally sets them on the basis of their child user stories’ schedule states.
  • You can set the states of tasks.
  • User stories with tasks have hybrid schedule states. If you change the state of a task, Rally ensures that the schedule state of the user story that the task belongs to is consistent with the new set of states of its tasks.
  • You can change the schedule state of a leaf user story, possibly making it inconsistent with the states of its tasks if it has any. But Rally may override your change later if the state of any of its tasks changes or if the user story acquires or loses tasks.

When you execute the schedule-state operation, or when you copy a tree and specify a schedule state for the copy, RallyTree applies your chosen schedule state only to leaf user stories without tasks. However, in the copy operation, every user-story copy is initially a leaf without tasks, and your schedule-state specification is therefore applied to it, even if it will momentarily acquire tasks copied from its original, and when their states are set the user story’s schedule state may be derivatively modified by Rally.

RallyTree converts your chosen schedule state to a state and gives that state to all tasks. To reduce the 5 schedule states to 3 states, RallyTree converts Needs Definition to Defined, and Accepted to Completed.

After RallyTree gives states to tasks, Rally may perform derivative modifications of the schedule states of the tasks’ user stories.

Test-case creation

To customize the test cases that are created by the test-case creation operation, maintain a file named custom.js in a top-level directory named data in your local repository. In that file, define a variable named caseNames as follows:

exports.caseNames = {
  'User story name 0': [
    'Test case name 0',
    'Test case name 1',
    'Test case name 2'
  ],
  'User story name 1':[
    'Test case name 1'
  ]
};

The caseNames object can have any user-story names as property keys. For each such key, you may specify 0 or more test-case names. If any eligible user story has a name identical to the specified user-story name, RallyTree will create test cases with the specified test-case names (if any) for that user story. For any eligible user story whose name is not in caseNames, RallyTree will create 1 test case, and it will have the same name as the user story. (When you execute the test-case operation, you decide whether all user stories or only leaf user stories are eligible.)

Architecture

Platform

RallyTree is a node.js application that can be installed locally. It creates a web server running on localhost:3000.

The core functionality of RallyTree is performed by the code in the index.js file. Each operation is powered additionally by code in an operation-specific file, such as copyTree.js. That code displays and dynamically modifies a report page located in a companion file, such as copyReport.html.

Server-client interactions

RallyTree interacts with its users, in part, as an ordinary web server. As such, it serves three pages:

  • an introduction

    introduction page

  • a request form

    request page

  • a report

    report page

The interaction in the report page employs streaming. The report page, when served, initially displays counts of 0. But, as soon as it finishes loading, it automatically submits a request to the server. To fulfill the request, the server:

  • creates a server-sent-event stream
  • performs the form’s requested operation on the specified tree of user stories
  • while processing work items, keeps sending new events to the browser

If an error occurs, including an error arising from the request form being improperly completed, the server emits an error event, causing an error message to be displayed on the report page.

Each (non-error) event identifies one of the count fields in the report and a new count. When the event arrives, the browser updates the report by repopulating that field with the new count. The user experience is to see the report page updating itself with increasing counts. Eventually the updating stops. That tells the user that the operation is complete.

As an exception, the tree-documentation report contains a tree representation. For each user story, it shows the name; counts of tasks, test cases, and child user stories; and an array of the child user stories of the user story. The task and test-case counts are cumulative. Thus, for a user story with child user stories, its task and test-case counts are the counts of tasks and test cases of all its descendant user stories. (If these counts were not cumulative, they would always be 0, because user stories with child user stories never have tasks or test cases.)

The server never sends an “operation complete” message to the browser. Arguably, relying on the user to detect completion by waiting long enough for further updates is a fragile solution, and the architecture should be revised to determine definitively when an operation is complete and inform the user of this fact.

Server-service interactions

RallyTree interacts not only with users, but also with Rally.

Its interactions with Rally take place by means of Rally’s web-services API.

At present these interactions are mediated by Rally’s Node integration package, rally-node. It simplifies the task of making requests to Rally and receiving the responses.

However, freeing RallyTree from dependence on rally-node may be beneficial, because:

  • Implementing a single-host adaptation, described below, might improve RallyTree’s speed, but monitoring this adaptation to verify that it is working properly requires reading response headers, which rally-node does not permit.
  • The rally-node package depends on the request library. But that library went into “maintenance mode” in early 2019. Its developers recommend using other, better libraries. This suggests that rally-node is not being energetically updated, and dependence on it could pose reliability, security, or other problems for RallyTree.

Asynchronicity

Design

The Rally operations are asynchronous, so operations on sets of work items can, in principle, occur in parallel. For example, if a user story has 6 child user stories, an operation can be requested on each of the 6 children, and Rally can perform those 6 operations in parallel.

When operations are performed in parallel, the order of the operations is not forecastable, and it cannot be foreknown which operation will be the last one. Therefore, RallyTree is not designed to

  1. process a request,
  2. then serve the report page after it is fulfilled.

Instead, RallyTree is designed (for most operations) to

  1. immediately serve the report page,
  2. let the report page request an operation on a tree,
  3. perform the operation,
  4. and incrementally send new events to the report page as they occur.

The report page displays the totals and updates them as new totals arrive. When the user sees that the total(s) are no longer being updated, the user knows that the process is finished. The wait time between updates depends on the time that Rally needs to process dependencies and synchronize its application servers. This time can reach almost 20 seconds per update in the project-change operation.

The documentation operation differs from the others in this respect. Its output can be voluminous. Updating it on every increment would annoy users and slow the result. Therefore, this operation outputs a result only if no subsequent result emerges within 1.5 seconds. Under normal conditions, there is only one (final) output from the documentation operation.

Limitations

Asynchronicity in RallyTree has limitations. Some theoretically independent operations are not in fact independent. Errors can be thrown, for example, when:

  • A child user story is updated while its parent user story is being updated.
  • A test case is linked to a user story while another test case is being created.
  • A user story is linked to a parent while another user story is linked to the same parent.

These are concurrency conflicts. The errors that they throw are sometimes misleading, such as

Not authorized to perform action: Invalid key

In other cases they correctly point to asynchronicity problems, such as

Error copying user story: Concurrency conflict:
[Object has been modified since being read for update in this context]

According to Broadcom, truly independent requests can be made at any frequency without causing errors, because they are queued if they arrive faster than the 24-requests-at-once limit.

But Broadcom acknowledges that interdependent requests will throw concurrency-conflict errors if they are made too rapidly in succession.

While Broadcom has not quantified “too rapidly”, Broadcom support engineer Dave LeDeaux informed us on 28 January 2020, “right now, it can take up to 8 seconds before our read-only databases are in sync to the read-write database due to some additional software we have in place to support the database migration we are undergoing. So the concurrency problem is likely especially bad right now.”

Adaptations

Introduction

In the above-cited knowledge-base article, Broadcom also suggests adaptations to prevent concurrency conflicts:

  • inserting pauses between requests
  • trapping errors and retrying operations until they succeed
  • restricting all requests to a single host in its server cluster

Previous solutions

RallyTree previously implemented error-trapping and pause-insertion adaptations suggested by Broadcom. These adaptations were deployed in retry and pause branches. The results of both adaptations were unsatisfactory. Even with 30 retries or with pauses of 1 second after every request, concurrency conflicts continued to arise.

Current solutions

Single-host adaptation

RallyTree currently implements, as an option, the single-host adaptation suggested by Broadcom. The implementation sends a request to Rally to obtain a cookie and then sends back to Rally, with each request in the selected operation, three attributes (JSESSIONID, SUBBUCKET, and SUBSCRIPTION) from that cookie. Those cookie attributes ask Rally to use, for handling those requests, the same server it used for the original request, instead of arbitrarily choosing a server from the Rally cluster.

This adaptation is employed by default. To turn it off, you can clear the value of the first input field in the request form. That prepopulated value is the three cookie attributes.

Preliminary testing indicates that operations perform about 15% faster, on average, when the single-host adaptation is on than when it is off. To determine whether this adaptation improves performance for you, you can look at the console in the browser developer tools. There, the elapsed time of each operation is displayed.

RallyTree elapsed-time report

The single-host adaptation does not prevent concurrency conflicts, contrary to what one might infer from the Broadcom documentation.

Sequentiality

RallyTree also implements a sequentiality adaptation. This is not one of those suggested by Broadcom. It consists of returning JavaScript Promises from each request and postponing the next request until the current Promise has been resolved.

For example, suppose a user story has six child user stories. Without this adaptation, RallyTree could process all six children in a batch. JavaScript would start working on them quasi-simultaneously, in no predictable order. Each child’s update could entail a change to the parent. To avoid a concurrency conflict, Rally would need to prevent any change to the parent between the time it reads the parent for child A and the time it updates the parent for child A. But Rally does not prevent such changes. If Rally updates the parent for child B during that interval, a concurrency conflict occurs. The sequentiality adaptation prevents such concurrency conflicts.

Concurrency conflicts have not occurred in the verdict-acquisition or documentation operation, where the Rally data are read but not modified. Those operations are performed in parallel whenever possible.

Installation and usage

To install and use RallyTree:

  • Clone it.

  • Make its directory the current directory.

  • Install dependencies with npm install.

  • If you want any values to be automatically entered into the request form, create a file named .env in the current directory.

  • If you want your Rally username and Rally password to be automatically filled in, add these two lines (replacing the placeholders with your actual email address and password) to .env:

    • RALLY_USERNAME=xxx@yyy.zzz
    • RALLY_PASSWORD=xyzxyzxyz
  • If you want your workspace’s prefix for user stories (such as US) to be automatically filled in, add this line (replacing US with your prefix, if different) to env: storyPrefix=US.

  • Run the application with node index. This opens the introduction page in your default web browser.

  • Click the “Proceed” link to get the request page.

  • Follow the instructions to specify the operation you want performed and whether the single-server adaptation should be turned on or off.

Support

Please report bugs, comments, feature suggestions, and questions to Jonathan Pool (jonathan.pool@cvshealth.com).

Bugs

In mid-January 2021, a Rally bug was discovered that stopped RallyTree’s verdict-acquisition operation from returning correct results. Rally wrongly reported that test cases with defects had defect counts of 0. RallyTree relied on the correctness of this count. This bug caused reports from the verdict-acquisition operation to omit all defects. Broadcom confirmed this bug and stated that we would be notified of progress in its correction. A temporary code change was introduced to circumvent this bug. On 13 April 2021 Broadcom notified us that the bug had been corrected, and we verified the correction.

Version notes

Version 1.9.2 copies more properties of user stories and test cases than previous versions did.

Version 1.9.1 increases the modularization of the application by moving two additional operation-specific blocks of code from index.js to the operation-specific code files.

Version 1.9.0 modularizes the code by moving the operation routines into distinct operation modules, such as copyTree.js. For each operation request, only that operation’s module is imported. Some bugs in the previous master branch are also corrected. In case of undiscovered bugs or incompatibilities, the previous master branch has been preserved as the unitary branch.

Version 1.8.2 improves and corrects some operation reports and pervasively refactors the code in the index.js file. In case of undiscovered bugs or incompatibilities, the previous master branch has been preserved as the oldmaster branch.

Version 1.8.1 adds an option to the planification operation, to associate the existing test cases with the new test folders rather than copying the test cases into the test-folder tree.

Version 1.8.0 adds the test-case grouping operation.

Version 1.7.4 adds support for feature parents of user stories. In the documentation operation, the output identifies the parent of the root user story, which may be a feature or a user story. In the copy operation, you can choose either a user story or a feature as the parent of the tree copy.

Version 1.7.3 extends the scope of the project-change operation, making it ensure that test cases belong to the specified project even when their user stories already do.

Version 1.7.2 adds the option to specify a project to which created test cases will belong and refactors some code for parsimony.

Version 1.7.1 corrects the obsolete destination of the “Use RallyTree again” link at the end of each report.

Version 1.7.0 reorganizes and expands project changes and scheduling.

  • Previous versions checked releases and iterations for validity within the project of the root user story, but other user stories in the same tree might belong to other projects, which might not contain releases or iterations with the same names, so release or iteration names could be invalid and an error could be thrown. This version, as explained above, does not assign releases or iterations unless you force all user stories to belong to the same project.
  • Previous versions ignored the states of tasks; this version handles them as described above.
  • Needs Definition was previously not one of the selectable schedule states; now it is.
  • This version adds the ability to select a release, an iteration, and/or a schedule state (or state) for copies.

Version 1.6.1 adds options to specify the owner and the project of copies of work items.

Version 1.6.0 introduces the planification operation.

Version 1.5.6 corrects a navigation bug by making the request page open in a new tab and removing the link on that page to the introduction page.

Version 1.5.5 adds scoring to the verdict operation and renames that operation to “scoring”.

Version 1.5.4 makes the request page more compact, corrects the prepopulation of the user-story input fields, and reorders the request-page sections for usability.

Version 1.5.3 makes the treatment of user-story formatted-ID prefixes conform to Rally. Previous versions assumed this prefix is “US”. However, Rally allows workspace administrators to customize this prefix. This version stops assuming that it is “US”, but lets you automatically apply your workspace’s prefix with an entry in the .env file. If you do that, your prefix appears as the initial value in the tree-root input, instead of being a placeholder as it was in previous versions, so you can complete it with the numeric part of the formatted ID. This version also adds “Accepted” to the set of selectable schedule states in the scheduling operation.

Version 1.5.2 removes prohibitions on user stories that have test cases without having tasks, and on user stories that have both test cases and child user stories. Those prohibitions reflected practices of some Rally users, but exceeded Rally’s own prohibitions. This version still assumes that no user story can simultaneously have tasks and child user stories, since Rally prevents that. This version also corrects bugs, including the erroneous treatment of the build in the test-case-creation operation as an optional input. Finally, this version implements a temporary change in the verdict operation to counteract a Rally bug that, in January and February 2021, returns 0 as the count of defects of a test case, regardless of how many defects it really has.

Version 1.5.1 adopts a systematic naming convention for attributes and properties, making the code more transparent. It does not change the user interface.

Version 1.5.0 introduces the single-host adaptation. It also incorporates internal nomenclature improvements and a refactoring to consolidate nine JavaScript files into one. Finally, it removes the pause and retry branches that were present starting in the 1.1 versions.

Version 1.4.3 liberalizes the validity criteria of the ownership-change operation. The operation previously treated user stories with test cases and no tasks as invalid. This version treats them as valid.

Version 1.4.2 adds an option to the copy operation: copying user stories and test cases, but not tasks. This version also corrects a bug in version 1.4.1 that mislocated copied work items.

Version 1.4.1 makes all user stories, tasks, and test cases in a tree copy inherit the project affiliation of the user story designated as the parent of the copy root. Previously they were affiliated with the user’s default project. This change is believed to fit the most common use cases, but, if necessary, the project affiliation of the items in the tree copy can be changed with the project-change operation.

Version 1.4.0 adds the project-change operation.

Version 1.3.9 adds to the scheduling report a count of the schedulable user stories. This allows you to check for the possibility that the scheduling operation prematurely stops and, if so, to redo the operation. Such premature stops and thrown errors are observed occasionally. Because they are not consistent, it is surmised that they arise from connection terminations or synchronization failures by the Rally servers.

Version 1.3.8 reorders the operations on the request page, placing the copy operation first (as the default) and the documentation operation last. Previously documentation was first and copying was last. This change fulfills a request from users based on which operation they most often and least often use.

Version 1.3.7 makes the implementation of the test-case-creation operation conform to the documentation. Previously the operation was incapable of creating more than 2 custom test cases per user story. In this version, the operation can create arbitrarily many test cases per user story.

Version 1.3.6 corrects a defect in the logic of the scheduling operation. The operation previously assumed that release and iteration formatted IDs are globally unique, although in fact they are only project-unique. Multiple projects can have a release named “2021.PI4”, for example. Specifying a release or iteration could cause RallyTree to find one in a different project, and then Rally would refuse to assign it to a user story.

Version 1.3.5 further generalizes the schedule-state property, adding “Completed” as an option.

Version 1.3.4 generalizes the option in the scheduling operation to set a schedule state. Instead of only “Defined”, you can now choose to set the schedule state to “In-Progress”, if you set it at all.

Version 1.3.3 adds the ownership restriction to the creation of test-case results. This permits the user to exclude test cases that have not been considered because somebody else will run them, by making those test cases ownerless before creating results. (This handles the case in which successive testers make themselves owners of test cases they will test. The operation will need to be made more configurable in order to handle the case in which a tree’s test cases are given multiple owners in advance and only one owner’s test cases need results created.)

Version 1.3.2 corrects a defect by using the open package to make the opening of the introduction page cross-platform.

Version 1.3.1 adds to the scheduling operation the option to put each scheduled user story into the “Defined” schedule state.

Version 1.3.0 adds the scheduling operation.

Version 1.2.4 removes the service of the introduction page from Node. Rather than serving the page, the application spawns a shell that opens the page with the default browser. This eliminates concurrency errors that occasionally arose when the application attempted to serve the PNG file on the introduction page and prunes some functions from the index.js file.

Version 1.2.3 changes how the tester of a created result is defined. Originally the current user was made the tester. In this version, the owner of the test case is made the tester.

Version 1.2.2 makes the ownership-change operation sequential. It was originally performed in parallel, but concurrency conflicts occasionally occurred.

Version 1.2.1 changes the rule for recognizing a defect during test-result acquisition. In previous versions defects were discovered when they belonged to user stories. However, current CVS Health practice attaches defects only to test cases, not to the user stories that the test cases are attached to. Version 1.2.1 recognizes defects according to this rule. In addition, version 1.2.1 embodies a pervasive refactoring of the code.

Version 1.2.0 adds the result-creation operation.

Version 1.1.9 adds customization to test-case creation.

Version 1.1.8 adds test cases to the work-item types that the user may choose to copy.

Version 1.1.7 adds tasks to the work-item types that are subject to ownership change.

Version 1.1.6 adds task counts to the tree-documentation report.

Version 1.1.5 makes the report of ownership changes more detailed, itemizing the changes by work-item type.

Version 1.1.4 offers the option to include tasks when copying a tree.

Version 1.1.3 offers the option to identify a test set and associate each new test case with it.

Version 1.1.2 adds test-case counts to the tree-documentation report, and adds tallies of defect severities to the test-result report.

Version 1.1.1 adds rank to the properties of a user story that are copied from the original, when a tree is copied. This makes the user stories of the copy appear in the same order as the originals when the tree display is ordered by rank.

Version 1.1.0 (in the master branch) removes the “retry” accommodation, improves the diagnostic specificity of error messages, and makes the request page more compact.

Version 1.0.9 changes the method by which the user specifies a user story or test folder. Previously the user entered a URL, which could vary in format and become very long. Now the user enters a formatted ID, such as “US379495” or “TF5775”.

Version 1.0.8 adds the ability to make new test cases belong to a specified test folder.

Version 1.0.7 makes two improvements over version 1.0.6:

  • The URL of a user story no longer needs to have its basic minimal format. It can now also be one of the longer URLs associated with a user story, such as when the user story is displayed in a filtered search output.
  • A defect in the application logic that caused some user stories to be overlooked has been corrected.

Version 1.0.6 makes the verdict operation more informative and adds a documentation operation.

Version 1.0.5 adds a verdict operation.

Version 1.0.4 adds documentation and corrected bugs.

Version 1.0.3 adds a task-creation operation and improves error reporting.

Version 1.0.2 adds a copy operation.

Version 1.0.1 adds a test-case-creation operation.

Version 1.0.0 includes only one operation: ownership change.