Note that http://wg21.link/p1389 was written to give advice about what patterns to use and what to avoid.  It is not a document that teaches C++, it is meta: it gives guidelines to creating C++ teaching materials.

We have since chosen a modular approach as described in http://wg21.link/p1725
We have a github repository at https://github.com/cplusplus/SG20/ where we are building modular teaching guidelines following http://wg21.link/P2193 and http://wg21.link/p1725


On Wed, Jan 26, 2022 at 4:24 PM Victor Eijkhout via SG20 <sg20@lists.isocpp.org> wrote:
I’m looking at http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2019/p1389r0.html#delayreferences-references

And the code example there is almost literally taken from the textbook I’m writing. P1389 continues:

"Without a genuine use-case, references can make seem C++ look rather quirky! Instead, it is recommended that students be exposed to references in a practical fashion, such as when passing parameters to functions.”

I agree, which is why that code example in my book is preceded by 

and followed by

Ok, so now my question to the author of that statement in P1389: please write a sample explanation of references in the context of parameter passing, without first explaining references.


SG20 mailing list