[jbosstools-issues] [JBoss JIRA] (JBDS-2759) Document Maven Tools functionality in User Guide

[Max Rydahl Andersen (JIRA)]

    [ https://issues.jboss.org/browse/JBDS-2759?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13035334#comment-13035334 ] 

Max Rydahl Andersen commented on JBDS-2759:
-------------------------------------------

I think the basics usecases are:

* Create a Maven project from scratch
* Import an existing Maven Project

And most likely importing is going to be what *majority* of users are doing.

The content of this depends if we want to cover explaining how maven itself works or just focus on what is important in context of eclipse.
My vote is mainly for focusing what is importing in context of eclipse and thus explain how maven integration in eclipse works - what is good  and what is bad about it.

I would explain how you can edit the pom.xml to add/change a dependency and when that is done explain the need to run Update project configuration.

Then I would cover how to setup using an additional repository in settings.xml like maven.repository.redhat.com either manually or by using our maven repository dialog.

Advanced how to: 
* cover how to enable autdownload of source and javadoc
* usage of maven source lookup container (it somewhat automatces the autodownload)
* explain maven lifecycles and how it can result in warnings/errors you as user don't really care or want to care about
   - in here explain how jboss tools and eclipse provides some autoconfiguration based on what plugins are useed
    and document the maven properties you can use to turn on/off this auto config such as enable hibernate, annotation processors, war projects etc.



> Document Maven Tools functionality in User Guide
> ------------------------------------------------
>
>                 Key: JBDS-2759
>                 URL: https://issues.jboss.org/browse/JBDS-2759
>             Project: Developer Studio (JBoss Developer Studio)
>          Issue Type: Feature Request
>          Components: documentation, requirements
>            Reporter: Michelle Murray
>            Assignee: Michelle Murray
>              Labels: JBDS80_Approved_Scope
>             Fix For: 8.x
>
>
> Add a chapter to the JBDS User Guide on Maven Tools.



--
This message was sent by Atlassian JIRA
(v6.3.11#6341)