prose like prose, code like code - Dashboard
2,793
visibility Viewed
91
Total Responses
91
flag Completed
100%
timelapse Completion Rate
0
do_not_disturb_on Dropouts
28 min
access_time Average Time
 
Countries Responses
US 50.55%
RU 7.69%
DE 6.59%
GB 6.59%
CA 5.49%
IE 3.30%
IL 3.30%
CN 2.20%
AU 2.20%
FR 2.20%
HU 1.10%
CH 1.10%
NL 1.10%
DK 1.10%
Unknown 1.10%
ES 1.10%
SE 1.10%
UA 1.10%
BR 1.10%
Total 100.00%
In general, your argument in this post aligns with my experiences and perspective
Answer Count Percent
20% 40% 60% 80% 100%
Strongly disagree 3 3.37%
Disagree 11 12.36%
Neutral 4 4.49%
Agree 38 42.7%
Strongly agree 32 35.96%
Other 1 1.12%
Total 89 100 %
In general, your argument in this post aligns with my experiences and perspective - Text Data for Other
06/22/2020 71079587 I agree, but I just think its the nature of the beast, and always has been, and maybe always will be.
Code review tools (e.g., Review Board) tend to exclude non-engineers from the content review process
Answer Count Percent
20% 40% 60% 80% 100%
Strongly disagree 1 1.23%
Disagree 5 6.17%
Neutral 4 4.94%
Agree 28 34.57%
Strongly agree 41 50.62%
Other 2 2.47%
Total 81 100 %
Code review tools (e.g., Review Board) tend to exclude non-engineers from the content review process - Text Data for Other
06/22/2020 71079587 I agree, but I think most people don't like to give reviews, regardless of the tools.
06/17/2020 69961167 non-engineers could use code review tools - but they are resistant to using them
Creating documentation isn't too different from the workflows in a creative writing workshops. In both cases, you write content and review with others, and then make updates based on the reviews. Write - review - update - repeat.
Answer Count Percent
20% 40% 60% 80% 100%
Strongly disagree 3 3.41%
Disagree 3 3.41%
Neutral 10 11.36%
Agree 45 51.14%
Strongly agree 25 28.41%
Other 2 2.27%
Total 88 100 %
Creating documentation isnt too different from the workflows in a creative writing workshops. In both cases, you write content and review with others, and then make updates based on the reviews. Write - review - update - repeat. - Text Data for Other
06/21/2021 116651885 Also: The work is time-and-content sensitive; and you have to use the tools, processes, and environments required for intake, source control, single sourcing, task tracking, SLAs, doc builds, and so on.
06/22/2020 71079587 I agree, to a point. It depends on your specific workflow and requirements.
Gathering input and feedback from many different groups and perspectives is one of the most important techniques for creating good documentation
Answer Count Percent
20% 40% 60% 80% 100%
Strongly disagree 0 0%
Disagree 7 7.87%
Neutral 2 2.25%
Agree 30 33.71%
Strongly agree 50 56.18%
Other 0 0%
Total 89 100 %
Gathering input and feedback from many different groups and perspectives is one of the most important techniques for creating good documentation - Text Data for Other
Reviewing only the parts of docs that have changed by looking at file diffs isn't as effective because it doesn't present the changes in the context of the whole
Answer Count Percent
20% 40% 60% 80% 100%
Strongly disagree 0 0%
Disagree 8 8.99%
Neutral 9 10.11%
Agree 26 29.21%
Strongly agree 42 47.19%
Other 4 4.49%
Total 89 100 %
Reviewing only the parts of docs that have changed by looking at file diffs isnt as effective because it doesnt present the changes in the context of the whole - Text Data for Other
06/19/2020 70202894 You can actually take a look at parts before and after. So it is not only about viewing only the diff.
06/17/2020 69981128 depends the review
06/17/2020 69961167 in my experience this is also true if someone isn't familiar with markdown syntax and cannot envision the formatting updates as well
06/17/2020 69952303 It depends on the nature of the revision