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> wrote:
>>
>>> On 26 Aug 2014, at 10:18, Pete Muir <pmuir(a)redhat.com> wrote:
>>>
>>>> On 26 Aug 2014, at 09:27, Paul Robinson <paul.robinson(a)redhat.com>
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> 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