This project enables you to easily set up and run developer experience surveys on Slack.
Developer experience surveys are a great way to get concrete, honest feedback on what is (and what isn't) working in your organization right now around areas such as perceived ease of delivering software, perceived productivity, and employee satisfaction.
Features includes:
- Configurable texts, questions, and options
- Comes with sane defaults
- Requires only that you set up a bot app in Slack
You might also be interested in this full solution, which is deployable on AWS and includes all components such as API management, functions, and storage, as well as support for Slack's slash commands for opting in/out users.
Code is written in TypeScript, bundled with ncc, and tested with AVA. Errors are logged with mikrolog.
Install the dependencies with npm install or your equivalent command.
- How has your day been?
- Did you make progress toward your goals today?
- Have you been able to focus today?
- Is your tooling working well and fast?
- Is the cognitive load manageable?
{
"heading": "Developer Experience survey",
"optionsPlaceholder": "I feel...",
"finishHeading": "*Finish*",
"finishButtonText": "Finish the survey :tada:",
"optInMessage": "You are now opted-in to the developer experience survey!",
"optOutMessage": "You are now opted-out from the developer experience survey.",
"completedMessage": "Thanks for taking the time to share with us!",
"questions": [
"*1. How has your day been?*",
"*2. Did you make progress toward your goals today?*\nConsider the clarity of goals, how engaging the work is, your control of the structure of work...",
"*3. Have you been able to focus today?*\nConsider the number of meetings, interruptions, unplanned work...",
"*4. Is your tooling working well and fast?*\nConsider CI, code tools, platform tools, build and test times, code review times...",
"*5. Is the cognitive load manageable?*\nConsider project complexity, friction, processes, communication..."
],
"options": [
{
"text": "Positive",
"value": "positive"
},
{
"text": "Neutral",
"value": "neutral"
},
{
"text": "Negative",
"value": "negative"
}
]
}- Create a Slack app. Set it to whatever name you want.
- In
OAuth & Permissions, make sure that the following scopes are enabled:chat:write,commands, andusers:read. Note down the "Bot User OAuth Token".
import { createNewDevExSurvey } from 'devexbot';
const authToken = 'my-auth-token';
const userIds = ['U123456789', 'U987654321'];
const devex = createNewDevExSurvey({ authToken });
await devex.open(userIds);The custom configuration will merge the base configuration (see above) with your own configuration options.
Basic validation is done to check for empty values, correct options objects, and ensuring questions and options have a non-zero length.
Most types are exported, so you can use these in your own code to make it easier to write.
import { createNewDevExSurvey, DevExSurveyConfigurationInput } from 'devexbot';
const authToken = 'my-auth-token';
const config = {
"heading": "Our weekly DX check-in!",
"optionsPlaceholder": "I thought it was...",
"questions": [
"*1. How well has the tooling worked this week?*",
],
"options": [
{
"text": "Super",
"value": "super"
},
{
"text": "OK",
"value": "ok"
},
{
"text": "Bad",
"value": "bad"
}
]
};
const userIds = ['U123456789', 'U987654321'];
const devex = createNewDevExSurvey({ authToken, config });
devex.open(userIds);- You need to supply a list of user IDs for
devexbotto send anything. The reason for this is quite simple: All surveys are personal and private, and to send such a message, we need to send them to each individual user with Slack'schat.postMessageAPI method. - It is not possible to "close" open (unanswered) surveys in the current state of the implementation. Once a survey is opened, it stays open until the user acts on it. This does not seem like something that needs to be implemented - see below.