id	summary	reporter	owner	description	type	status	milestone	component	version	severity	resolution	keywords	cc
12709	Boost.Asio uses Boost.Coroutine v1, yet Boost.Coroutine v2 references it as a usage example	Antoine Poliakov <antoinep92@…>	olli	"In http://www.boost.org/doc/libs/1_62_0/libs/coroutine2/doc/html/coroutine2/motivation.html there is a code sample using `boost::asio::yield` to demonstrate the benefits of using coroutines.

This code sample seems to be copy-pasted from Boost.Coroutine v1 http://www.boost.org/doc/libs/1_62_0/libs/coroutine/doc/html/coroutine/motivation.html, and it's **quite misleading** since from what I can tell (documentation and include chains in the code, `boost::asio::yield` is built on top of Coroutine v1 and not Coroutine2.

So if I try to build the code sample from Coroutine2 documentation, I get a warning saying that Boost.Coroutine is deprecated and I should be using the v2, which I thought I was because that's where the sample came from.

Ideally it would be good if Boost.ASIO was ported to Coroutine v2, but in the meantime it might be better to remove the ASIO code sample in Coroutine v2 documentation."	Bugs	new	To Be Determined	coroutine	Boost 1.62.0	Problem		coroutine2 asio spawn yield