Improve explanation of `api` vs `implementation` in manualI've reordered a one or two things and attempted to bring a little more clarityto this topic in the Java Library Plugin chapter of the user manual. I havealso linked directly to this particular section from the main Building Javaprojects chapter so that it gets more attention.
Move content from feature preview document to user guideTo make it sustainable and easy to discover for users. The contentis reworded to fit into the existing documentation and with the newterminology definitions. Some explanations are moved to the releasenotes, which previously linked to the preview document, to betterillustrate the features there.Features documented:- optional dependencies- BOM support- compile/runtime scope separation- metadata sources (was already added to documentation earlier, therefore it can also be removed from the preview doc)