Support for Drupal 7 is ending on 5 January 2025—it’s time to migrate to Drupal 10! Learn about the many benefits of Drupal 10 and find migration tools in our resource center.
I am reporting https://www.drupal.org/node/2092643 to moderators because:
The annotations in the provided book.routing.yml example are confusing.
book.render contains the annotation:
# For page callbacks that return a fully-themed HTML page use _controller.
book.export contains the annotation:
# Because this route does not return HTML, use _controller.
These two comments as they are currently worded seem to contradict each other, making it confusing.
Comments
Comment #1
jhodgdonThanks for the report! Fixing issue title and category, adding tags.
If you know how to fix the page, you can also feel free to edit it. It's part of the Community Documentation, and you are part of the Drupal community. :)
Comment #2
Eyal ShalevThe issue has been fixed by acbramley