News for hackers. Stuff that matters.
Re:Chinese authorities say overtime '996' policy is illegal by burnished on Friday August 27, 2021 @10:23AM (#28328150)
I haven't written a lot of documentation, would you say that it requires the same level of mental focus? I understood the dividing line of 'time on task' as being what is difficult/taxing, whereas admin or docs (important tasks!) are relatively light weight.
Re:Chinese authorities say overtime '996' policy is illegal by ericbarrett on Friday August 27, 2021 @10:30AM (#28328254)
I would; it’s a bit like teaching. For general documentation you need to refresh your mental model of the system and organize it to be explained to somebody without your familiarity. For specific areas (APIs, for example) you must review the assumptions in that domain and summarize them.
Re:Chinese authorities say overtime '996' policy is illegal by plorkyeran on Friday August 27, 2021 @11:52AM (#28329368)
Writing _good_ documentation absolutely can be just as tiring as creating the thing being documented. It's quite common to not particularly value documentation quality and be happy with a mess of words churned out with little thought because at least it exists, but ensuring that it's accurate, covers all of the little details, and is organized well requires some careful thought and editing processes.

With a formal division between "deep thought" work and "easy" work, I'd be inclined to churn out a rough draft of documentation in the second time box but then spend at least as much time as that in the first time box cleaning it up.

Re:Chinese authorities say overtime '996' policy is illegal by HeyLaughingBoy on Friday August 27, 2021 @12:32PM (#28329808)
TSP/PSP makes no task differentiation according to what is difficult. If it directly relates to project deliverables, then it's considered time on task.

I'd say that documentation that is expected to be used is every bit as difficult to create as good code.