If you encounter the problem of the two classloaders in Devtools, there's no hint that there are two classloaders and that some configuration changes might help you. You only get an IllegalArgumentException. Googling does not help because the exception is not mentioned in the docs. Futhermore, the docs sound like the problem can only occur in IDEs, which is not the case.

Comment From: aahlenst

@wilkinsona I reworked my PR. There's now a separate section about diagnosing classloading issues incl. an admonition block that points out that devtools might cause them.