[Starlingx-discuss] Important! Storyboard Story Tag & Prefix Policy

Khalil, Ghada Ghada.Khalil at windriver.com
Mon Jul 23 14:17:09 UTC 2018


FYI, the StoryBoard API documentation is available at:
https://docs.openstack.org/infra/storyboard/webapi/v1.html#


From: Jones, Bruce E [mailto:bruce.e.jones at intel.com]
Sent: Sunday, July 22, 2018 9:25 PM
To: Xie, Cindy; starlingx-discuss at lists.starlingx.io
Subject: Re: [Starlingx-discuss] Important! Storyboard Story Tag & Prefix Policy

There are links on the wiki page to pre-built queries under the Story and Bug Tracking section.

The links look like this: https://storyboard.openstack.org/#!/story/list?status=active&project_group_id=86&tags=stx.bug.

You can change the highlighted text to query for various things.  I'm still learning how to do this.

Ghada send me a script that shows what you can do if you know scripting:
#!/bin/bash
curl https://storyboard.openstack.org/api/v1/tasks?project_group_id=86|python -mjson.tool|grep -B11 "\"assignee_id\": null" |egrep "title|\<id\>|story_id" > unassigned_tasks.txt
sed 's/,//g;/^$/d' unassigned_tasks.txt | paste  - - -

From: Xie, Cindy
Sent: Sunday, July 22, 2018 5:33 PM
To: Jones, Bruce E <bruce.e.jones at intel.com<mailto:bruce.e.jones at intel.com>>; starlingx-discuss at lists.starlingx.io<mailto:starlingx-discuss at lists.starlingx.io>
Subject: RE: [Starlingx-discuss] Important! Storyboard Story Tag & Prefix Policy

Bruce,
Do you have a pre-build query and can be shared with the team? For example, stx.bug.not_resolved? Stx.feature.merged?

Thx. - cindy

From: Jones, Bruce E [mailto:bruce.e.jones at intel.com]
Sent: Saturday, July 21, 2018 3:07 AM
To: starlingx-discuss at lists.starlingx.io<mailto:starlingx-discuss at lists.starlingx.io>
Subject: [Starlingx-discuss] Important! Storyboard Story Tag & Prefix Policy

I have made an executive decision as to how we should use the Storyboard tool.  After discussing the matter with Ghada and our OpenStack Foundation team, I have documented our Tag and Prefix policy[0] on the wiki, in the section called "Story and Bug Tracking" [1].  I'm doing this because Reasons [2].

Here is a summary of the policy.

All Stories in the Storyboard tool shall have Tags.  If you create a new Story, make sure to add the tag "stx.new".  We can then query this story and assign it to a sub-project and a release.  If you don't tag it that way, we may never find it again.   Assigning Stories to releases is a process that I think should be driven by the Cores together with the Release team.  That is TBD.

If you are filing a bug, please also add the "stx.bug" tag.  I have updated all of the currently entered bugs with that tag.  If you are filing a Story for a feature, please add the "stx.feature" tag.  I'm going to update the existing feature stories to add that tag soon.

I'd like to break down planning for the project into a set of Sub-projects.  Each will have its own tag so the team working on that Sub-project can manage their work items.  I'll be adding those tags soon as well.

Should a team decide to add additional tags to Stories,  for example so they can build a Board in Storyboard for their work, feel free, but please update the document on the wiki [0].

Note that as far as I can tell, each tag needs to be entered one at a time in the web UI.

     Brucej

[0] https://wiki.openstack.org/wiki/StarlingX/Tags_and_Prefixes
[1] https://wiki.openstack.org/wiki/StarlingX#Story_and_Bug_Tracking
[2] We need to assign issues to sub-projects and releases, and keep track of bugs and features separately to simplify doing bug scrubs and release planning.  Tags are easily searchable and don't clutter up the text fields.  Using queries instead of Worklists or Boards gives us both flexibility and reliability.



-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.starlingx.io/pipermail/starlingx-discuss/attachments/20180723/31eb3db1/attachment.html>


More information about the Starlingx-discuss mailing list