Suggestions for improving section 16.4
In section 16.4 of v0.14 of the book, I've found that the following confuses me:
* Section 16.4.1: The text "Once you've configured Nexus to be the mirror for all repositories, Maven will now consult the local installation of Nexus instead of going out to the central Maven repository." is confusing. When I first read it, I thought that it was directly related to example 16.1 which it isn't as in example 16.1 Nexus is only the mirror of central. Secondly, the part "instead of going out to the central Maven repository" is incorrect if we're talking about settings up a mirrors for ALL repositories. Thirdly, it's talking about configuring Nexus while the section is regarding how Maven should be configured to use Nexus as a mirror. Some kind of re-phrasing is needed.
* Section 16.4.1: "After you've run a few builds against your local Nexus installation, you can then start to browse the contents cached in your local instance of Maven." should most likely be changed to "...you can then start to browse the artifacts cached in Nexus.".
* Section 16.4.2: I guess that "...will allow you to use the Nexus public group which resolves artifacts from four repositories..." talks about the default configuration of Nexus as it might not be true for an altered configuration. Some remark regarding this would be good.
* The title of section 16.4 is "Configuring Maven to Use Nexus Repositories". However, sections 16.4.3 and especially 16.4.4 and 16.4.5 is regarding configuring repositories in Nexus. Either the title should be changed or the sections moved/rearranged.
Thanks,
/Anders
* Section 16.4.1: The text "Once you've configured Nexus to be the mirror for all repositories, Maven will now consult the local installation of Nexus instead of going out to the central Maven repository." is confusing. When I first read it, I thought that it was directly related to example 16.1 which it isn't as in example 16.1 Nexus is only the mirror of central. Secondly, the part "instead of going out to the central Maven repository" is incorrect if we're talking about settings up a mirrors for ALL repositories. Thirdly, it's talking about configuring Nexus while the section is regarding how Maven should be configured to use Nexus as a mirror. Some kind of re-phrasing is needed.
* Section 16.4.1: "After you've run a few builds against your local Nexus installation, you can then start to browse the contents cached in your local instance of Maven." should most likely be changed to "...you can then start to browse the artifacts cached in Nexus.".
* Section 16.4.2: I guess that "...will allow you to use the Nexus public group which resolves artifacts from four repositories..." talks about the default configuration of Nexus as it might not be true for an altered configuration. Some remark regarding this would be good.
* The title of section 16.4 is "Configuring Maven to Use Nexus Repositories". However, sections 16.4.3 and especially 16.4.4 and 16.4.5 is regarding configuring repositories in Nexus. Either the title should be changed or the sections moved/rearranged.
Thanks,
/Anders
1
person likes this idea
I like this idea!
Tell me when this idea gets some attention.
The more people who like this idea, the more it gets noticed.
The more people who like this idea, the more it gets noticed.
-
Inappropriate?16.4.1-Shouldn't "Nexus" and "Maven" be swapped in that sentence?
Loading Profile...


