Tutorial lacks explanation of newly introduced concepts not covered by pre-requisites #7162
Description
Page URL
https://dart.dev/learn/tutorial/object-oriented
Page source
https://github.com/dart-lang/site-www/blob/main/src/content/learn/tutorial/object-oriented.md
Describe the problem
There were a number of "new" concepts introduced in this part of the tutorial but with very little or no explanation which was inconsistent with previous lessons. The code blocks lack the "Highlights from the preceding code:" section which is explains anything new introduced in that code. For example, the flag() method in the ArgResults class - how can we infer that the value of the options Map is going to be a bool and that it would be true if the flag exists? Another example is the addCommand() method in the CommandRunner class - what does command.runner = this; mean? (I suspect you need a better grasp of object orientated programming to understand it which is not a prerequisite for this lesson).
Expected fix
Ensure that new concepts not covered by the pre-requisites or explained or provide links / references for additional help
Additional context
No response
I would like to fix this problem.
- I will try and fix this problem on dart.dev.