The Path to Zen

Don’t Forget To Describe Your constructor-arg

One often overlooked feature in Spring bean definitions is the ability to add a <description> element to almost everything: beans, properties, or constructor arguments. It makes a lot of sense especially in the case of <constructor-arg>, because usually setting a bean property is fairly obvious:

But not so when the above is done in a <constructor-arg>. Constructor arguments are not looked up by name, but by index or type:

Instead, this would make it a lot clearer:

My only wish is for the Spring team to consider adding a 'description' attribute.