[boost] usage of auto in tutorials

Subject: [boost] usage of auto in tutorials
From: Stephan Menzel (stephan.menzel_at_[hidden])
Date: 2019-03-19 07:11:34

Hello all,
I was eagerly awaiting the release of the 1.70 beta, especially for
outcome, which I have much use for, having lots of async functionality.
While looking at the tutorial here that
https://www.boost.org/doc/libs/1_70_0_beta1/libs/outcome/doc/html/index.html
I notice that auto is used instead of the types. Is there a background to
this?
I question if this is such a good thing in tutorials. The first thing I
like to know about a new lib is the types and classes it offers and auto
obfuscates this.
Is there any consensus in the boost community as to how and if tutorials
and docs should use auto? I have concerns about this and feel it doesn't
increase the otherwise great quality of documentation and tutorials for new
libs.

Cheers,
Stephan