Created documentation for UX changes #6595
Conversation
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## main #6595 +/- ##
==========================================
+ Coverage 89.89% 90.00% +0.11%
==========================================
Files 90 91 +1
Lines 24138 24447 +309
Branches 4492 4567 +75
==========================================
+ Hits 21699 22004 +305
+ Misses 1679 1676 -3
- Partials 760 767 +7 ☔ View full report in Codecov by Sentry. 🚀 New features to boost your workflow:
|
There was a problem hiding this comment.
Granted, we should definitely be more public with minutes from meetings.
But minuting stuff in our documentation would be quite a departure from the norm. I would prefer that the documentation remain a 'user manual'; this means that wherever possible it is our official, unambiguous word, with no speculation/conversation.
GitHub is the ideal place for looser, less curated conversation. I would like to see more items like #5165 (comment) on our repo; this seems to be in a similar vein. Note this comment:
Note this issue is not intended as a debate, hence why it is not posted as a discussion. The below conversations took place in real time, with a group deliberately sized to aid decision making.
As the above implies, the default should probably be Discussions, not Issues. We could perhaps create a new discussions category for minutes, if this is something we aim to do more of?
There was a problem hiding this comment.
I suppose that might simplify things by making this a single page, rather than a section?
There was a problem hiding this comment.
Yeah I'm happy with that. Especially since there's already a UX discussion, the minutes could be added there, or linked at least.
There was a problem hiding this comment.
Having agreed on this, and deleted the minutes from the docs, please could you find an appropriate place in Discussions to store the minutes?
docs/src/further_topics/user_experience/ux_past_discussions/ux_discussion_02-05-25.rst
Outdated
Show resolved
Hide resolved
docs/src/further_topics/user_experience/ux_past_discussions/ux_discussion_02-05-25.rst
Outdated
Show resolved
Hide resolved
|
I agree with most comments here, the minutes page I had forseen being a bit of a mess anyway, and putting it as a discussion seems wise. Adding the discussion guide to Philosophy feels a little crammed in. I could happily be vetoed, my feelings aren't strong, but it feels a bit like it's not so much a philosophy as it is guiding a process. The philosophy would be "we're having regular meetings, because". |
Yes I see your point, let's not mess with the Philosophy page |
🚀 Pull Request
Related #4799
Closes #6498
Left to do:
Add mention of the cultural changes we wish to seeMinutes removed from PRDouble check the minutes make senseMinutes removed from PR