The link to yield-from.pdf in the Further Reading section of Classic Coroutines gives a 404. It points to https://www.fluentpython.com/content/extra/classic-coroutines/images/yield-from.pdf but the content should not be there.

Issue originally reported by @dongzeXD at https://github.com/fluentpython/example-code-2e/issues/15, related to an example in post Classic Coroutines:

In <6> annotations ："Each iteration in thisloop creates a new instance of averager; each is a generator object operating as a coroutine." and <7>:"Whenever grouper is sent a value, it’s piped ．．．, the value it returns is bound to results[key]. The while loop then proceeds to create another averager instance to consume more values."

Would I replace while True with yield? This seems easier to understand

When rendering internal links, the O'Reilly toolchain renders only figure and listing identifiers, like "Figure 1". However, instead of Figure 1, Asciidoctor renders the full caption as the link text.

For example, in https://www.fluentpython.com/extra/multi-character-emojis/ the the link to Figure 1 appears as the full caption, which is ridiculous:

Screenshot of running two_flags.py from [ex_two_flags]. The AA combination is shown as two letters A inside dashed squares. shows the output of two_flags.py: combining regional indicators to produce flags

Maybe there is a way to configure this in Asciidoctor...

Asciidoc uses single and double underscores for italic text. Many occurrences of __dunder__ names need to be fixed in the .adoc files by replacing each _ with _, the escape code for _. For example: __dunder__. 😥

PS. The proprietary O'Reilly asciidoc toolchain doesn't use the double underscore for italic to avoid issues with __dunder__ notation, since they publish lots of books about Python. But in this site I use Asciidoctor, so this became an issue as I moved content from the book.