Software Delivery Discussion Cards

Temporarily published to https://wayne-tw.github.io/engineering-capability-assessment-cards/

Cards used to assess the DevSecOps capability of a team.

Inspired by the physical software delivery cards from Matthew Skelton

Use these cards to assess the DevSecOps capability of a team which you can then plot on the DevSecOps capability model.

Local Dev

# OPTIONAL use the awesome `reload` which auto-refreshes your browser on change using websockets
# `npm install -g webpack webpack-cli reload`

# install dev and app deps
npm install

# in the root of the repo
node_modules/.bin/webpack --watch
(cd docs && reload -e "html|js|css|json|yml")

# browse to http://localhost:8080/

Pushing to prod

Published via Github pages atm, so build to docs using webpack and just push to main to publish.

Temporarily published to https://jujhars13.github.io/devsecops-assessment-cards/

# simply build for prod
NODE_ENV=production node_modules/.bin/webpack build
# now git commit and push to main

The dataset as CSV to JSON

We find working with CSVs the most straightforward using a standard spreadsheet app. You can then produce the other formats we need (jsonl -> json) using Python csvkit and then jq to spit out a denormalised json array that's easier to digest by our client-side js:

# use Python csvjson from csvkit to convert our csv file to a jsonl then to a json file
# pip3 install csvkit
csvjson cardData.csv | jq -c '.[]' > /tmp/data.jsonl
jq -s '.' /tmp/data.jsonl > src/js/cardData.json

# as one line
# To generate questions set from CSV to json
$(csvjson cardData.csv | jq -c '.[]' | jq -s '.' > src/js/cardData.json)
# To generate moreCardInfo from CSV to json
$(csvjson moreCardInfo.csv | jq -c '.[]' | jq -s '.' > src/js/moreCardInfo.json)

TODO

fix more-info accordian style
create CSV file for more-info data
update readme with instructions for generating more-info json
populate csv with more-info data

Licence

Fill your boots