Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
student:scrumj:help [2020/04/07 10:54] – Added note about adding all team members. bernstdhstudent:scrumj:help [2023/06/26 11:09] (current) – [Getting Started] Remove embedded HTML lam2mo
Line 12: Line 12:
 ====Getting Started==== ====Getting Started====
  
-A sprint backlog can be created using the [[ https://docs.google.com/spreadsheets/d/1bI35ElgIrMCnwfhddW3lgvfDJKuZNDEJL4yiaKWd6ig/copy | scrumj link ]] (which actually makes a copy of an empty sprint backlog).+A sprint backlog can be created using the [[ https://docs.google.com/spreadsheets/d/1bI35ElgIrMCnwfhddW3lgvfDJKuZNDEJL4yiaKWd6ig/copy | scrumj link ]] (which actually makes a copy of an empty sprint backlog).  This document should then be shared with all members of the team (including the product owner).
  
-When a sprint backlog is initially copied it contains just an Overview page and an Assignments page. The first things a user should do after copying a sprint is to re-name it (in the usual way), set the start/end dates (by clicking on <key>scrumj</key>+<key>Set dates...</key>), and add *all* of the team members to the Assignments page by entering their names in the cells to the right of the header/label. (Note: You cannot add team members after you have added a story, so add all of them now.) +When a sprint backlog is initially copied it contains just an Overview page and an Assignments page. The first things a user should do after copying a sprint is to re-name it (in the usual way), set the start/end dates (by clicking on <key>scrumj</key>+<key>Set dates...</key>), and add **all** of the team members to the Assignments page by entering their names in the cells to the right of the header/label. (Notes: 1. The start date should be the date the sprint actually starts, not the date of the planning meeting. 2. You cannot add team members after you have added a story, so add all of them now.) 
  
-A story can be added to a sprint by clicking on <key>scrumj</key>+<key>Add one story</key> or <key>scrumj</key>+<key>Add multiple stories</key>. The tabs for the stories are color-coded as follows.+Note that the first time you use the scrumj menu you may be asked to give a script attached to the document permission to run. You must give the script (which is named ''%%scrumj.gs%%'') permission to do so. 
 + 
 +A story can be added to a sprint by clicking on <key>scrumj</key>+<key>Add one story</key> or <key>scrumj</key>+<key>Add multiple stories</key>. As with most names, it is better to avoid the use of spaces (which are normally used as delimiters) and special characters in story names. 
 + 
 +The tabs for the stories are color-coded as follows.
  
 ^ Color ^ Meaning ^ ^ Color ^ Meaning ^
-| <html><span style="color:#00CC00">Green</span></html> | All tasks completed and all acceptance criteria confirmed | +| <color green>Green</color> | All tasks completed and all acceptance criteria confirmed | 
-| <html><span style="color:#FFFF00">Yellow</span></html> | All tasks completed but some acceptance criteria unconfirmed | +| <color yellow>Yellow</color> | All tasks completed but some acceptance criteria unconfirmed | 
-| <html><span style="color:#FFA500">Orange</span></html> | Some tasks incomplete but, somehow, all acceptance criteria confirmed | +| <color orange>Orange</color> | Some tasks incomplete but, somehow, all acceptance criteria confirmed | 
-| <html><span style="color:#CC0000">Red</span></html> | Some tasks incomplete | +| <color red>Red</color> | Some tasks incomplete | 
-| <html><span style="color:#000000">Black</span></html> | Story was deactivated during sprint planning meeting |+| <color black>Black</color> | Story was deactivated during sprint planning meeting |
  
 The name of the active tab is rendered in green. The name of the active tab is rendered in green.
Line 68: Line 72:
 A task or acceptance criteria will always be added at the end of the respective area and will be numbered accordingly. The user must enter the description and assignee (and effort for tasks). When a task is completed or an acceptance criteria is confirmed, the user should click on the corresponding status checkbox. The date will be entered automatically and, if permissions have been granted, the name of the person who clicked the status box will also be entered. A task or acceptance criteria will always be added at the end of the respective area and will be numbered accordingly. The user must enter the description and assignee (and effort for tasks). When a task is completed or an acceptance criteria is confirmed, the user should click on the corresponding status checkbox. The date will be entered automatically and, if permissions have been granted, the name of the person who clicked the status box will also be entered.
  
-The information in the effort+The information in the effort summary, task summary, and acceptance criteria summary is calculated from the information in the task area and acceptance criteria area. 
 ====User Interaction==== ====User Interaction====
- summary, task summary, and acceptance criteria summary is calculated from the information in the task area and acceptance criteria area. 
  
 A task can be removed by clicking on <key>scrumj</key>+<key>Delete one task...</key>. Similarly, an acceptance criterion can be removed by clicking on <key>scrumj</key>+<key>Delete one acceptance criterion...</key>. A task can be removed by clicking on <key>scrumj</key>+<key>Delete one task...</key>. Similarly, an acceptance criterion can be removed by clicking on <key>scrumj</key>+<key>Delete one acceptance criterion...</key>.
Line 81: Line 85:
 ====Known Issues==== ====Known Issues====
  
-Because of a defect in Google Sheets, you will sometimes get an error message when you try to make change to a story. This is because each sheet is protected (to prevent you from editing cells that you shouldn't), and the defect causes the protected ranges to be changed when they shouldn't be. The problems this causes can usually be corrected by clicking on <key>scrumj</key>+<key>Fix protections on current stories</key>. If this doesn't work, you can remove all protections (but you must then be careful not to change cells that you shouldn't change).+Because of a defect in Google Sheets, you will sometimes get an error message when you try to make a change to a story. This is because each sheet is protected (to prevent you from editing cells that you shouldn't), and the defect causes the protected ranges to be changed when they shouldn't be. The problems this causes can usually be corrected by clicking on <key>scrumj</key>+<key>Fix protections on current stories</key>. If this doesn't work, you can remove all protections (but you must then be careful not to change cells that you shouldn't change).