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

Sande Gilda sgilda at redhat.com
Tue Aug 26 16:56:15 EDT 2014


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 at redhat.com> wrote:
>>>
>>>> On 26 Aug 2014, at 10:18, Pete Muir <pmuir at redhat.com> wrote:
>>>>
>>>>> On 26 Aug 2014, at 09:27, Paul Robinson <paul.robinson at redhat.com> wrote:
>>>>>
>>>>>> Rafael,
>>>>>>
>>>>>> It'd be worth reading the "[Wolf] Revisting embedding repositories in POMs for developer materials" thread on enterprise-maven-list at 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 at redhat.com> 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 at 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 at 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 at lists.jboss.org
>>> https://lists.jboss.org/mailman/listinfo/jbossdeveloper
>> _______________________________________________
>> jbossdeveloper mailing list
>> jbossdeveloper at lists.jboss.org
>> https://lists.jboss.org/mailman/listinfo/jbossdeveloper
> _______________________________________________
> jbossdeveloper mailing list
> jbossdeveloper at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/jbossdeveloper



More information about the jbossdeveloper mailing list