Documentation on @Async is confusing and biased to XML [SPR-17458]

[spring-projects-issues]

Dave Syer opened SPR-17458 and commented

Look at this section of the user guide (on @Async): https://docs.spring.io/spring-framework/docs/current/spring-framework-reference/integration.html#scheduling-annotation-support-qualification. It explains how to customize the Executor but with reference to an unlinked section that is XML-based ("the 'annotation-driven' element"). It would be better just to repeat what is in the other section (or link to it) and make sure it refers to annotations.

---

Reference URL: spring-guides/gs-async-method#12 (comment)

Referenced from: pull request #2009, and commits 3232825

[spring-projects-issues]

Dimitrios Liapis commented

I could pick this up. I guess repeating the XML section would be clearer since I don't believe it's possible to "anchor" link on an code element.

[spring-projects-issues]

Dimitrios Liapis commented

Juergen Hoeller I've created a PR for this.