The Developer Experience Automator
This tool was built by @thinkingserious and @mbernier at SendGrid in order to help scale the Developer Experience Team. We needed to spend less time tracking every single data point so that we could spend more time with our community.
Since 2015, we have learned that the methods (FIFO and/or gut-based-prioritization) we were using to manage the work we need to do would not work with our small team or for our open source community.
Intercom's RICE formula for prioritization totally changed our workflow. We implemented this as our prioritization scheme for or backlog within a Google Doc and it served us very well until Hacktoberfest 2017. All of a sudden, our "magic spreadsheet" fell over. Our automations were not keeping up and we were spending as much time manually pushing github Webhooks as we were manipulating our spreadsheet and merging pull requests. It was a mess.
We found pain points with our spreadsheet, our automations, and our backlog. This project is the culmination of what we learned over the past couple years and it is helping us to be sgnificantly more effective.
Getting the Tool
To get the basic tool and all the plugins you can use:
git clone https://github.com/sendgrid/dx-automator .
Installation
This project is built on Python, flask, and PostGresQL. It can be deployed as a Docker Container or on a standalone server.
Docker Install
Clone the repo
git clone https://github.com/sendgrid/dx-automator.git
cd dx-automatorCreate the docker machine
docker-machine create -d virtualbox dx
eval "$(docker-machine env dx)"Build the docker container
docker-compose build
docker-compose up -dGet the IP of your docker container and curl to make sure it's running
DX_IP="$(docker-machine ip dx)"
curl http://$DX_IP:5001/ping
Set up the database
docker-compose run dx-service python3 manage.py recreate_db
docker-compose run dx-service python3 manage.py seed_dbValidate that the items are seeded into the database
curl http://$DX_IP:5001/itemsRun the tests to make sure everything is working!
docker-compose run dx-service python3 manage.py testYour Server or On your machine
Clone the repo
git clone https://github.com/sendgrid/dx-automator.git
cd dx-automatorCreate a virtual environment and activate it
python3.6 -m venv env
source env/bin/activateInstall the python dependencies
pip install -r requirements.txtSet up the database and seed it
python manage.py recreate_db
python manage.py seed_dbStart up the flask server and get your IP
python manage.py runserverGo to http://Your_IP:5001/items in your browser or via curl to verify the items in the database
curl http://$DX_IP:5001/itemsRun the tests to make sure everything is working!
python manage.py testTroubleshooting
For any issue, comment, or suggestion - please make an issue in the github repo. We want everything out in the open, so that if someone finds the same issue they can find the answer easily! This also makes it easy for us to track all our conversations. Yes, we have this system hooked up to this repo!
Docker Machine is not working properly
If you have already installed and can't get the eval statement to work, try this to restart your machine:
docker-machine start dxThen try from this step from install again:
eval "$(docker-machine env dx)"Contributing
Everyone who participates in our repo is expected to comply with our Code of Conduct.
We welcome contributions in the form of issues, pull requests and code reviews. Or you can simply shoot us an email.
Attributions
We believe in open source and want to give credit where it's due. We used the amazing tutorial at testdriven.io to guide us in setting a solid foundation using flask, docker, and (eventually) node and react. From this tutorial, we began to build and iterate.