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

jhodgdon’s picture

Title: Moderation report for Structure of routes » Structure of Routes page is confusing
Category: Task » Bug report
Issue tags: +d8docs, +developer

Thanks 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. :)

Eyal Shalev’s picture

Status: Active » Closed (fixed)

The issue has been fixed by acbramley