In our last meeting, I brought up a vague tension around Launch re-done website ASAP, marking under construction? and issue tracking here vs GitLab. Afterward, @Salt and I talked and clarified it: It’s time- and energy-consuming to move between platforms.
After opening the forum thread, it would take a few minutes poking around GitLab to figure out which issue(s) were about the same topic. It also added lots of time switching between tabs, to find which one has the relevant information.
In the meeting I proposed that we should use GitLab to discuss actionable work, instead of #shoveling. However, the forum has better moderation tools and discussion can clog up issues, getting in the way of actually doing the work. So instead, we propose:
- When it’s clear we want to track something, create a GitLab issue for it.
- Any related forum topics should link to the issue.
- If a forum topic leads to a decision, it should be captured in the linked GitLab issue, including a link back to the forum topic.
(I’ve done that for this topic)
I have a closely related concern about how much time we spend summarizing our discussions.
Right now we might discuss in a meeting (and take notes), then summarize the outcome here and on GitLab, then update the original issue on GitLab to reflect the changes… This is a whole lot of extra work spent documenting what we decided, instead of just doing it.
It’s not a problem when it comes to the “think tank” side of things. The work there is mostly promoting our ideas, and a well-documented decision making process helps with that; the documentation is part of the actual work. And we expect it to be read by others many times over, so it’s worth a little polish.
On the website side, I think we’re spending more time keeping old comments up to date than we save by not having to read out-of-date stuff — if any, since frequent editing means I have to go back and re-read old stuff, instead of just reading the latest addition to the conversation.
So, I hope linking more creates room for less summarizing & editing.