Information sleuthing - Dashboard
1,135
visibility
Viewed
92
Total Responses
92
flag Completed
100%
timelapse Completion Rate
0
do_not_disturb_on Dropouts
9 min
access_time Average Time
Countries | Responses |
---|---|
US | 45.65% |
IN | 7.61% |
CA | 7.61% |
GB | 4.35% |
DE | 4.35% |
IE | 3.26% |
PL | 3.26% |
AU | 2.17% |
NZ | 2.17% |
BR | 2.17% |
HK | 2.17% |
CN | 2.17% |
HR | 2.17% |
SE | 2.17% |
DK | 1.09% |
ES | 1.09% |
FI | 1.09% |
BE | 1.09% |
FR | 1.09% |
RO | 1.09% |
RS | 1.09% |
HU | 1.09% |
Total | 100.00% |
How do you feel when you're left out of the loop about changes that affect docs?
Answer | Count | Percent |
|
Very upset | 11 | 12.09% |
|
Kind of annoyed | 55 | 60.44% |
|
I'm desensitized so I don't care | 15 | 16.48% |
|
It's fine | 8 | 8.79% |
|
I don't mind at all | 2 | 2.2% |
|
Other | 0 | 0% |
|
---|---|---|---|---|---|---|---|---|
Total | 91 | 100 % |
How do you feel when youre left out of the loop about changes that affect docs? - Text Data for Other
What sources are the best for identifying needed doc updates? Pick your top 3.
Answer | Count | Percent |
|
Email broadcasts | 33 | 12.64% |
|
Chatrooms | 30 | 11.49% |
|
JIRA (or similar ticking systems) | 85 | 32.57% |
|
Wikis | 31 | 11.88% |
|
Commit logs | 31 | 11.88% |
|
QA test scripts | 19 | 7.28% |
|
Other | 32 | 12.26% |
|
---|---|---|---|---|---|---|---|---|
Total | 261 | 100 % |
What sources are the best for identifying needed doc updates? Pick your top 3. - Text Data for Other
09/01/2021 | 124735715 | Functional Specifications, Offers to customers, etc. |
05/31/2020 | 67582722 | Weekly meetings with coders |
05/07/2020 | 65313071 | Meetings |
05/02/2020 | 64722802 | Aha roadmaps |
05/01/2020 | 64546058 | roadmaps |
04/23/2020 | 63762138 | Confluence, internal company portals, document management systems |
04/20/2020 | 63474439 | Asking people |
04/14/2020 | 62785747 | sprint planning |
04/07/2020 | 62172605 | I attend the weekly QA meetings. Also in direct communication with Project Mgr and Tech Support staff. |
04/04/2020 | 62022426 | Precognition & Telepathy |
Should tech writers embrace a pull rather than push method for staying updated?
Answer | Count | Percent |
|
Yes | 57 | 64.04% |
|
No | 5 | 5.62% |
|
Other | 27 | 30.34% |
|
---|---|---|---|---|---|---|---|---|
Total | 89 | 100 % |
Should tech writers embrace a pull rather than push method for staying updated? - Text Data for Other
05/04/2022 | 144045875 | Both are important. |
05/07/2020 | 65313071 | Maybe, situational |
05/01/2020 | 64546058 | While demanding changes in dev workflows to include docs usually doesn't work, it's still a good idea to be a persistent advocate for docs. So when I do find changes that affect docs (as opposed to being notified), I send a gentle reminder to the team. |
04/23/2020 | 63762138 | This depends - pull is important, but it should not lead to engineers becoming even less motivated to push. The focus should be on push, with pull as a backup. |
04/14/2020 | 62785747 | Both |
04/09/2020 | 62364847 | should is a bit defeatist |
04/07/2020 | 62172605 | I don't understand this question. Not familiar with the terms you're using. |
04/06/2020 | 62075262 | Embrace implies a willing acceptance verging on celebration. I merely accept the need for pull methods. Think of it like grocery shopping: we accept that a store might be out of specific ingredients from tome to time. This causes more work on our end (creative or physical, depending on how urgently the ingredient is needed). However, if a store doesn’t have what I need more often than not, I’m either going to ask the store to stock it or shop elsewhere. Push is preferable. Occasional pull is acceptable. |
04/04/2020 | 62022426 | They should be given legal permission to use a cattle prod to politely remind others that documentation is critical to those who didn't suckling on Fortran sauce and snacking on machine code whilst reciting Ulysses in binary, sdrawkcab... HexaCoffemal with two spoons of Qbasic anyone? |
04/01/2020 | 61338135 | A combination of both, really, and a strong position on encouraging relationships and communication among the teams and writers. |
How do you stay aware of what's changed?
09/01/2021 | 124735715 | Try to build my own tracking method/system/framework that includes all the options above, besides alway (re)emphasizing that they have to let me know if there is any change affecting the documentation. |
03/17/2021 | 105001433 | Constantly checking up on developer's progress via slack or email. |
05/31/2020 | 67582722 | We have weekly meetings with support, coders, marketing and sales, where the scrum master or product owner briefly goes over all the changes they are about to implement during a sprint. We can also take part in daily standups whenever we want. On top of that we frequently have feature-specific release meetings, where we coordinate the need for different materials and communications related to the feature at hand, usually the scrum master or product owner is present. And of course we have a company chat, wiki, etc. |
05/11/2020 | 65580539 | Sometimes, hardly because there's no release management. But we mostly do is anticipate a last minute change and try to prevent it from happening two hours before a release. |
05/06/2020 | 65272287 | Our internal ticketing system for all intended changes (I also write the release notes, so I have to go through all the tickets anyway). Chats for side effects / unintended changes (these are usually noticed by our technical consultants or customers) |
05/02/2020 | 64722802 | regularly checking jira and aha, "watching" features and tickets so I get notified about changes. |
05/01/2020 | 64546058 | I'm in every engineering team slack channel and that's where I usually find changes that haven't been advertised. |
04/26/2020 | 63992354 | Being friendly with all the team members is the best to get updated about the changes. |
04/23/2020 | 63762138 | Sleuthing and coffee breaks with the people who are in the know |
04/21/2020 | 63611279 | I worked on a very small software team as the sole tech writer, and we would often take afternoon breaks together to walk around a nearby duck pond. During these walks we would sometimes talk about what we were working on and I would learn about new changes this way (if I hadn't already learned about them through other sleuthing methods). My team members knew much better than my manager how important it was for me to hear about these changes, so they were pretty good at giving me a heads-up about them, too. They were a great team! |