Issue Task Closed

#104101Maybe add a cheatsheet to simplify onboarding for first-time reviewers

Rozbeh Chiryai Sharahi 06/13/24, 18:42 updated 07/04/24, 13:16

Description

Some ideas:

- Clarify (shortly) who is allowed to review
- Note that many of the tasks are already covered by cgl and list is only for further common code-review steps
- Add a checklist of common code-review habits of experienced reviewers, see examples:
— check exception timestamps
— check declare strict
— check …
— check if documenation matches implementation

Further, annotate that this documentation is subject to

- frequent change
- not claiming completeness
- stays a cheatsheet without in dept information to be easily adapted over time

Reviews 0

No change resolves or names this issue in its commit message, and no comment links one.

History 6

  1. Rozbeh Chiryai Sharahi changed description 06/13/24, 18:43

  2. Rozbeh Chiryai Sharahi changed description 06/13/24, 19:12

  3. Georg Ringer commented and changed status New Resolved 06/25/24, 04:40

    Hey,

    thanks for the issue. I am closing it as a lot of that is already listed at https://docs.typo3.org/m/typo3/guide-contributionworkflow/main/en-us/BugfixingAZ/Index.html

    feel free to make a PR at github for the docs but IMHO it is not useful to make a list of things like timestamps, declare strict as this list would just be endless. this is why there are reviews and people helping you on the way.

    if you don’t agree, feel free to contact me via slack!

  4. Garvin Hicking commented 06/25/24, 05:56

    @rozbehsharahi I will create a PR in the docs and try to add some of your ideas there, would love to get your feedback and maybe help improving it towards contributors like you. Will post the link here when I get to it.

  5. Benni Mack changed status Resolved Closed 07/04/24, 13:16