Re: [jbossdeveloper] <repository /> on quickstarts pom.xml

So they, like me, don't RTFM? :-)

I didn't realize it was an issue. Who is fielding the complaints for this? I haven't been aware of any. And is it primarily people who use the Maven command line or JDBS?

Wouldn't it be easier to try to make the Maven setting configuration requirements more prominent? I really don't like the idea of adding the Maven repository to the POM files and then telling them it's not a good practice. If they see something, they will repeat it because, as you said, they don't read the instructions. The whole purpose of the quickstarts is to show how to code using best practices.

On 08/26/2014 04:44 PM, Rafael Benevides wrote: > The problem that we're trying to solve is that users don't read the > instructions :) > > So, they don't know that they have to configure the settings.xml until > they face a build problem. > > Em 8/26/14, 14:33, Sande Gilda escreveu: >> Sorry, I'm just back from PTO and catching up on this thread. >> >> I have run the quickstarts using both command line and JDBS without >> running into any problems, so I'm not really clear what problem we are >> trying to solve. Are there issues with asking the user to configure the >> settings.xml file with the content we provide? >> >> I'm adding Paul and Nikoleta to the thread to see how this might impact >> the quickstart testing and release process. >> >> On 08/26/2014 05:27 AM, Pete Muir wrote: >>> On 26 Aug 2014, at 10:26, Paul Robinson <paul.robinson(a)redhat.com&gt; >>> wrote: >>> >>>> On 26 Aug 2014, at 10:18, Pete Muir <pmuir(a)redhat.com&gt; wrote: >>>> >>>>> On 26 Aug 2014, at 09:27, Paul Robinson >>>>> <paul.robinson(a)redhat.com&gt; wrote: >>>>> >>>>>> Rafael, >>>>>> >>>>>> It'd be worth reading the "[Wolf] Revisting embedding >>>>>> repositories in POMs for developer materials" thread on >>>>>> enterprise-maven-list(a)redhat.com. There was quite a bit of >>>>>> discussion about doing this. The general opinion was that it >>>>>> would be a huge win for usability, but there are quite a few >>>>>> subtle problems with the approach. For example, productization >>>>>> are currently stripping off these repository definitions from >>>>>> quickstarts, so any solution is going to need to work for them. >>>>> We don’t currently put any repo definitions in quickstarts... >>>> Sorry, I should have been clearer. Productization would remove >>>> them if they exist. Quote from Julian Coleman: >>>> >>>> Right. Note, also, that the vman tool will strip out the >>>> <repositories> >>>> from the POM files that it processes. This means that all POM >>>> files for >>>> the IP builds (FSW/DV/BPMS) will not contain repositories. >>>> So, adding >>>> this information to settings.xml seems the only sensible option. >>> Not all platforms use vman afaik. >>> >>>>>> Pete came up with an alternative approach that helps to educate >>>>>> the developer about the configuration, in a better way then we >>>>>> have ATM (expecting them to read the docs). This approach was to >>>>>> include a plugin (that lives in maven central). This plugin >>>>>> would detect missing dependencies that would be available had >>>>>> the correct repository been defined in the settings.xml. There >>>>>> might also be an option to fix the configuration automatically? >>>>> I’m not so sure about this any more. >>>>> >>>>>> Paul. >>>>>> >>>>>> On 25 Aug 2014, at 13:50, Rafael Benevides >>>>>> <benevides(a)redhat.com&gt; wrote: >>>>>> >>>>>>> Hi all, >>>>>>> >>>>>>> On a look for a continuous improvement on developer user >>>>>>> experience and also because we have been constantly asked to >>>>>>> support issues related to the setup of >>>>>>> https://access.redhat.com/maven-repository to make the >>>>>>> quickstarts work, we want to include the <repository /> >>>>>>> definition on quickstarts pom.xml >>>>>>> >>>>>>> Actually the Archetypes already have the <repository /> on the >>>>>>> pom.xml file of the generated project. >>>>>>> >>>>>>> The idea here is to have the <repository /> with the >>>>>>> https://maven.repository.redhat.com/techpreview/all/ defined on >>>>>>> every quickstarts's pom.xml file with a comment on top of it >>>>>>> saying that this approach is not recommended but we included it >>>>>>> so users can test the quickstarts without further setup and >>>>>>> that it's recommended to use settings.xml. >>>>>>> >>>>>>> It will bring the following advantages: >>>>>>> - It will make ease to contributors and users >>>>>>> - Simplify the build. >>>>>>> - Simplify the Archetype synch process / No need to inject the >>>>>>> repo since it will come from the Quickstarts >>>>>>> - We can add a pre-defined comment above the pom.xml repository >>>>>>> definition to explain that we don't recommend that. >>>>>>> - We can also add this "comment" to QSTools to check/fix it. >>>>>>> >>>>>>> As a roadmap for it: >>>>>>> - We need to document that at the >>>>>>> https://github.com/jboss-developer/jboss-developer-shared-resources >>>>>>> >>>>>>> - We need to update the contributing guides >>>>>>> - We need to update QSTools to do this update on all >>>>>>> quickstarts for us. >>>>>>> >>>>>>> Max, Is there any restrictions on JBDS side ? >>>>>>> >>>>>>> Anyone else have any objections/comments on this $subject ? >>>>>>> >>>>>>> Thanks >>>>>>> -- >>>>>>> >>>>>>> Rafael Benevides | Senior Software Engineer >>>>>>> JBoss Developer >>>>>>> M: +55-61-9269-6576 >>>>>>> >>>>>>> <{a8aabf3a-4467-4e37-9bc5-48b1d7b494a2}_LATAM_RedHat.jpg> >>>>>>> >>>>>>> Better technology. Faster innovation. Powered by community >>>>>>> collaboration. >>>>>>> See how it works at www.redhat.com >>>>>>> >>>>>>> <linkedin.png> <youtube.png> >>>>>>> _______________________________________________ >>>>>>> jbossdeveloper mailing list >>>>>>> jbossdeveloper(a)lists.jboss.org >>>>>>> https://lists.jboss.org/mailman/listinfo/jbossdeveloper >>>>>> Paul. >>>>>> >>>>>> -- >>>>>> Paul Robinson >>>>>> JBoss Developer Team Lead (www.jboss.org) >>>>>> >>>>>> JBoss, a Division of Red Hat >>>>>> Registered in England and Wales under Company Registration No. >>>>>> 03798903 >>>>>> Directors:Michael Cunningham (US), Charles Peters (US), Matt >>>>>> Parson (US), Paul Hickey (Ireland) >>>>>> >>>>>> _______________________________________________ >>>>>> jbossdeveloper mailing list >>>>>> jbossdeveloper(a)lists.jboss.org >>>>>> https://lists.jboss.org/mailman/listinfo/jbossdeveloper >>>> Paul. >>>> >>>> -- >>>> Paul Robinson >>>> JBoss Developer Team Lead (www.jboss.org) >>>> >>>> JBoss, a Division of Red Hat >>>> Registered in England and Wales under Company Registration No. >>>> 03798903 >>>> Directors:Michael Cunningham (US), Charles Peters (US), Matt >>>> Parson (US), Paul Hickey (Ireland) >>> _______________________________________________ >>> jbossdeveloper mailing list >>> jbossdeveloper(a)lists.jboss.org >>> https://lists.jboss.org/mailman/listinfo/jbossdeveloper >> _______________________________________________ >> jbossdeveloper mailing list >> jbossdeveloper(a)lists.jboss.org >> https://lists.jboss.org/mailman/listinfo/jbossdeveloper > _______________________________________________ > jbossdeveloper mailing list > jbossdeveloper(a)lists.jboss.org > https://lists.jboss.org/mailman/listinfo/jbossdeveloper