QtCS2021 - Improve the contributor experience

Session Summary

Back in 2019 we had the discussion around the contribution experience, from which we gather many good ideas: some of them were never addressed, but others have been implemented, like for example the Qt project website and the Community Manager position that was open.

This session will try to address many of the open topics we had from that session looking at "What we could do" to keep improving the experience in topics like:

• What we can learn from the KDE contribution experience
• First contribution and initial setup
• Gerrit improvements, plugins, etc
• Creation of "good first issues" in JIRA
• ...and all the good ideas you probably have.

Update: Together with Eddy, we had a session on how to contribute to Qt, I recommend you to quickly check the slides (there are some videos with audio in the middle), so you can get some ideas on steps we could improve: https://qtinfo.dev/akademy2021_contribute/

Session Owners

• Cristián Maureira-Fredes (cristian.maureira-fredes@qt.io)

Notes

(Taken by kakoehne)

Feedback on https://qt-project.org

• Information is pretty 'crammed'. More overview documentation?
  • No 'why' part. _Why_ would I want to contribute?
  • Have separate page for the motivational part & link to it?

First time contribution experience

• Getting started is still pretty complicated
  • Creation of accounts (Qt Account, Gerrit account ...)
  • People gt lost
• Getting start with contribution needs simplified guide
  • Isn't that https://wiki.qt.io/Qt_Contribution_Guidelines ?
    • "Qt Contributing Guidelines" doesn't seem like the name that the Wiki page you would start with as an absolute newbie should have IMO.
  • Wiki is full of (half) outdated pages, should be cleaned up
• Split up between wiki information and https://doc.qt.io/qt-6/build-sources.html and https://doc.qt.io/qt-6/build-sources.html
  • Avoid redundancy!
• Reduce 'How to contribute' on https://qt-project.org to just a link?
  • Current list is not complete, and not too helpful for first-time contriburs
• Configuring and building Qt is complicated (like it is for KDE)!
  • https://doc.qt.io/qt-6/build-sources.html / https://doc.qt.io/qt-5/build-sources.html is pretty good though
• https://wiki.qt.io/How_to_Create_Qt_Account
  • This is partially duplicating 'Setting up Gerrit'
  • How_to_Create_Qt_Account is more graphical though
  • Interlink?
• More graphical instructions!
  • See animated gif at https://wiki.qt.io/Qt_for_Python

Gerrit

• Can we improve gerrit experience?
  • codereview.qt-project.org is already 2 versions behind upstream
  • 'Find reviewer' plugin?
    • https://gerrit.googlesource.com/plugins/maintainer/
  • Have we checked with other communities?
    • Check with other gerrit users, like libreoffice?
    • KDE Experience with move from fabricator to gitlab was very positive
      • Much better known workflow
    • Gerrit command line always feels a bit weird (git push <to strange branch>)
      • This is at the core of gerrit though; user base
• Feedback from first time users
  • Usage of bots are not obvious; what to do when it claims stuff?
  • Existence of CI; flow should be better visualized
  • Whom to add to a reviewer?
  • All explained somewhere in the guidelines, but not really self-explainatory
• Accept contributions also from github?
  • Aim is to have one process for everyone!
  • gitlab/gerrit integration bridge (https://gerrithub.io)?
    • Still requires learning gerrit for non-trivial commits (commit series)

Move to Github/Gitlab?

• What's stopping us?
  • Check with other communities

JIRA

Time is up; Follow up session tomorrow?