prose like prose, code like code - Dashboard
1,879
visibility Viewed
83
Total Responses
83
flag Completed
100%
timelapse Completion Rate
0
do_not_disturb_on Dropouts
28 mins
access_time Average Time
 
Countries Responses
US 53.01%
RU 8.43%
GB 6.02%
CA 6.02%
DE 4.82%
IL 3.61%
IE 2.41%
CN 2.41%
FR 2.41%
CH 1.20%
NL 1.20%
DK 1.20%
ES 1.20%
SE 1.20%
Unknown 1.20%
UA 1.20%
AU 1.20%
HU 1.20%
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 2 2.47%
Disagree 11 13.58%
Neutral 2 2.47%
Agree 36 44.44%
Strongly agree 29 35.8%
Other 1 1.23%
Total 81 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 0 0%
Disagree 4 5.41%
Neutral 4 5.41%
Agree 26 35.14%
Strongly agree 38 51.35%
Other 2 2.7%
Total 74 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 2 2.5%
Disagree 3 3.75%
Neutral 9 11.25%
Agree 41 51.25%
Strongly agree 24 30%
Other 1 1.25%
Total 80 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/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 8.64%
Neutral 2 2.47%
Agree 26 32.1%
Strongly agree 46 56.79%
Other 0 0%
Total 81 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
No Data To Display
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 9.88%
Neutral 7 8.64%
Agree 25 30.86%
Strongly agree 37 45.68%
Other 4 4.94%
Total 81 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