Was reading the thread about documentation and mandatory examples: https://devtalk.freecad.org/t/for-tool-tutorials-would-help-if-examples-were-made-mandatory/75531/1
Don’t want to derail that thread so here a separate one.
One of the main challenges is imho to find a particular function - and at least I am often unsure which one to use - there are many overlaps (e.g. look at the various loft-like features spread across several workbenches).
Perhaps it would make sense to have a kind of “meta workbench” with profiles like “beginner”, “advanced” and “expert” that assembles the best-of features of other workbenches that are interesting for a particular target audience in just one? So a profile of the meta workbench is essentially a list of feature references to other workbenches with the option to define a profile specific tooltip. These tooltips could then be written in a way that they are understandable for the target audience. And a hand selected, coherent set of features could be chosen (no matter from which workbench they originate). These tooltips could then also have links to further wiki pages or even to example designs.
That way one wouldn’t have to document every obscure feature here and now but could focus on documenting stuff that many people need and tailor the explanations towards different experience levels, by starting with such a “beginner” profile. And then working the way up from there. And it would be a way to rethink which features would make sense to be offered together in a workbench. (Currently a feature is often mainly in a particular workbench because it is from a particular developer - with many overlaps.)