@beauraines/sprint-tracker 0.6.2 → 0.6.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +9 -1
- package/README.md +16 -10
- package/cmds/config.js +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,7 +2,14 @@
|
|
|
2
2
|
|
|
3
3
|
All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
|
|
4
4
|
|
|
5
|
-
### [0.6.
|
|
5
|
+
### [0.6.4](https://bitbucket.org/beauraines/sprint-tracker/compare/v0.6.3...v0.6.4) (2023-12-07)
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
### Bug Fixes
|
|
9
|
+
|
|
10
|
+
* **config:** creates file when one doesn't exist ([#44](https://bitbucket.org/beauraines/sprint-tracker/issues/44)) ([1b3b525](https://bitbucket.org/beauraines/sprint-tracker/commit/1b3b525ecc7da1c884417cabf5c1b5aa06c01025)), closes [#42](https://bitbucket.org/beauraines/sprint-tracker/issues/42)
|
|
11
|
+
|
|
12
|
+
### [0.6.3](https://bitbucket.org/beauraines/sprint-tracker/compare/v0.6.1...v0.6.3) (2023-12-07)
|
|
6
13
|
|
|
7
14
|
|
|
8
15
|
### Features
|
|
@@ -18,6 +25,7 @@ All notable changes to this project will be documented in this file. See [standa
|
|
|
18
25
|
* compensates for unestimated work-items ([#19](https://bitbucket.org/beauraines/sprint-tracker/issues/19)) ([79bfa68](https://bitbucket.org/beauraines/sprint-tracker/commit/79bfa68bc30a6244416af10fcb26007957ee0f0f))
|
|
19
26
|
* makes config path work cross-OS ([4fae74b](https://bitbucket.org/beauraines/sprint-tracker/commit/4fae74b4ba45f5bf0f6d62c7b924d2ead01d0d73))
|
|
20
27
|
* Prettify output with cli-table3 ([682b72f](https://bitbucket.org/beauraines/sprint-tracker/commit/682b72f343c4cb34e8b36bb907065993f09b4c70)), closes [#5](https://bitbucket.org/beauraines/sprint-tracker/issues/5)
|
|
28
|
+
* **README:** adds installation instructions ([7ed182f](https://bitbucket.org/beauraines/sprint-tracker/commit/7ed182fa7676aa6d5b37f001d4d413e86fe9ee83))
|
|
21
29
|
* removes description from sprint display ([1ebd19e](https://bitbucket.org/beauraines/sprint-tracker/commit/1ebd19e3aca1c9dbaed021b84963b4dc7aa3e135))
|
|
22
30
|
* saves feature team backlog to a file ([01e79b5](https://bitbucket.org/beauraines/sprint-tracker/commit/01e79b53b9e067e33151e6d4f38b47900c7439ae))
|
|
23
31
|
* scripts to create visualizations ([a6aa4f8](https://bitbucket.org/beauraines/sprint-tracker/commit/a6aa4f861e526a5abb7fc9cb77af2c719aae1b24))
|
package/README.md
CHANGED
|
@@ -49,6 +49,11 @@ brew install docker sqlite
|
|
|
49
49
|
docker pull rocker/tidyverse
|
|
50
50
|
```
|
|
51
51
|
|
|
52
|
+
## Installation Instructions
|
|
53
|
+
|
|
54
|
+
The sprint-tracker can be installed with `npm -g i @beauraines/sprint-tracker` to be used locally. Once you've installed it, follow the [General Usage](#general-usage) instructions. If you're going to contribute to the package, see [Installation and Setup for Development](#installation-and-setup-for-development).
|
|
55
|
+
|
|
56
|
+
|
|
52
57
|
## General Usage
|
|
53
58
|
|
|
54
59
|
1. Update the config file with the path to the database `sprint-tracker config`. The database doesn't need to exist yet. This step only needs to be done the first time.
|
|
@@ -92,13 +97,13 @@ Non-working days and PTO will be recorded to be able to normalize Sprints with d
|
|
|
92
97
|
|
|
93
98
|
### Sprint Outcomes
|
|
94
99
|
|
|
95
|
-
1. Commitment
|
|
96
|
-
1. Delivered
|
|
97
|
-
1. Unplanned - Story
|
|
98
|
-
1. Unplanned - Bug
|
|
99
|
-
1. Descoped
|
|
100
|
-
1. Carryover
|
|
101
|
-
1. Carryover - External
|
|
100
|
+
1. Commitment: Initial sprint commitment
|
|
101
|
+
1. Delivered: Work completed this sprint
|
|
102
|
+
1. Unplanned - Story: All unplanned work brought into the sprint, whether completed or not
|
|
103
|
+
1. Unplanned - Bug: Unplanned work without a pre-existing story that was deemed critical enough to add to the sprint
|
|
104
|
+
1. Descoped: Committed work, removed from the sprint
|
|
105
|
+
1. Carryover: Incomplete, started or un-started, work from this sprint, assumed that it will carry over to the next sprint
|
|
106
|
+
1. Carryover - External: Work that was carried over due to blockers external to the scrum team. Use of this is optional, as an agile team should be fully self-sufficient.
|
|
102
107
|
|
|
103
108
|
|
|
104
109
|
### ERD
|
|
@@ -165,17 +170,18 @@ docker run -it --rm -v ${PROJECT_DIR}:/home/rstudio/projects/ ${IMAGE} su -c 'Rs
|
|
|
165
170
|
## Roadmap
|
|
166
171
|
|
|
167
172
|
1. ~~Build local database using sqlite3~~
|
|
168
|
-
2. ~~Script visualizations, possibly with R, graph-cli, chartsjs, PowerBI or AWS QuickSight~~
|
|
173
|
+
2. ~~Script visualizations, possibly with R, graph-cli, chartsjs, PowerBI, or AWS QuickSight~~
|
|
169
174
|
3. [Backlog health tracking](https://github.com/beauraines/sprint-tracker/issues/36)
|
|
170
175
|
4. Write API for adding data
|
|
171
176
|
5. Write API for getting visualizations
|
|
172
177
|
6. ~~Create database migrations~~
|
|
173
178
|
7. Deploy to cloud
|
|
174
179
|
8. Add sprint metrics
|
|
175
|
-
1. Average velocity over life of project
|
|
180
|
+
1. Average velocity over the life of the project
|
|
176
181
|
2. Recent average velocity
|
|
177
182
|
3. 90% confidence range. See <https://resources.scrumalliance.org/Article/its-target-forecast>
|
|
178
183
|
4. Daily points per developer
|
|
179
184
|
|
|
185
|
+
## Contributing
|
|
180
186
|
|
|
181
|
-
|
|
187
|
+
Please feel free to contribute by opening a pull request!
|
package/cmds/config.js
CHANGED
|
@@ -13,7 +13,7 @@ const handler = async function () {
|
|
|
13
13
|
const filename = 'sprintTracker.json'
|
|
14
14
|
const configFile = path.join(homedir(), filename)
|
|
15
15
|
|
|
16
|
-
if (helpers.fileExists(configFile)) {
|
|
16
|
+
if (await helpers.fileExists(configFile)) {
|
|
17
17
|
console.error(`Aborting. Existing configuration file ${configFile} found to not overwrite your values.`)
|
|
18
18
|
process.exit(1)
|
|
19
19
|
}
|