Developer's guide: Include resources for managing cognitive overload in Sage development

[mkoeppe]

Problem description:

• too much cognitive noise, all these packages and PRs and discussions [...]
• It doesn't help that the "fun" and "no fun" [packages are] mixed up in one place, in alphabetical order, no structure whatsoever.
• In a too noisy workplace one gets easily distracted and irritated

Originally posted by @dimpase in #36777 (comment)

As part of our goal to make the Sage development community more inclusive, we expand the developer's guide with strategies, resources, tools for managing cognitive overload in Sage development.

[mkoeppe]

From my personal experience, GitHub Issues and PRs are excellent tools for managing attention / focus.

An important part is that the scope of a PR is defined clearly in its description, and narrowed whenever necessary. Experienced developers know how to set the scope properly, and can recognize when the scope (in their own or others' PRs) needs to be narrowed.

We may need to revise our Reviewer's Guide to emphasize the importance of scope of a PR.

In particular, we should explain that reviewers need to use restraint when discussing topics outside of the scope of the PR in the comments of the PR. Although sometimes the "big picture" needs to inform decisions and discussions on a PR, there is the danger of creating distractions -- which can create cognitive overload for PR author and other reviewers.

[roed314]

Unfortunately, I'm not able to mediate between the two of you right now, since I'm at an AIM workshop this week and have a grant deadline on Thursday. I've asked the other members of the sage-abuse list to take a look, and I will return when I can.

[mkoeppe]

@williamstein Could you please delete the comments here that clearly violate our CoC, as reported by me to sage-abuse 2 days ago? Like you did in #36827 (#36827 (comment)). (I've taken screenshots.)

[williamstein]

@williamstein Could you please delete the comments here that clearly violate our CoC, as reported by me to sage-abuse 2 days ago? Like you did in #36827 (#36827 (comment)). (I've taken screenshots.)

Done. I just deleted all comments in this thread that added nothing and made me personally uncomfortable.