[forge-issues] [JBoss JIRA] (FORGE-1182) Addons generated by NewProjectWizard should contain a sample README.asciidoc

[George Gastaldi (JIRA)]

George Gastaldi created FORGE-1182:
--------------------------------------

             Summary: Addons generated by NewProjectWizard should contain a sample README.asciidoc
                 Key: FORGE-1182
                 URL: https://issues.jboss.org/browse/FORGE-1182
             Project: Forge
          Issue Type: Feature Request
          Components: Documentation
    Affects Versions: 2.0.0.Alpha11
            Reporter: George Gastaldi
            Assignee: George Gastaldi
             Fix For: 2.0.0.Alpha12


Asciidoc Template: 

{code}
== ADDON_NAME
:idprefix: id_ 
(choose one, do not modify, then add a second sentence with a brief description, starting with - "The ADDON_NAME addon enables blah blah...)
This addon provides *standalone* functionality, and *exports services* for use in other addons. 
This addon provides *standalone* functionality.
This addon *exports services* for use in other addons. 
This addon *provides classes* for use in other addons. 
This addon is a 'Furnace container' that provides *lifecycle* and *service registry* support for dependent addons.
        
=== Dependencies: None (or)
=== Depends on
[options="header"]
|===
|Addon |Exported |Optional
|DEP1
|yes
|no
|DEP2
|yes
|yes
|===
[TBD - Depends on FORGE-869 - image of the addon dependency graph - linked from /addon/dependencies.dot]
== Setup
This Addon requires the following installation steps.
=== Add configuration to pom.xml 
To use this addon, you must add it as a dependency in the *pom.xml* of your `forge-addon` classified artifact:
(Make sure the dependency is put all the way to the left, and uses 3 spaces for indentation of GAV)
[source,xml]
----
<dependency>
   <groupId>ADDON_GROUP_ID</groupId>
   <artifactId>ADDON_ARTIFACT_ID</artifactId>
   <classifier>forge-addon</classifier>
   <version>${version}</version>
</dependency>
----
== Features
ABCFactory for simple ABC blah:: 
Allows for blah blah
+
[source,java]
----
@Inject private ABCFactory factory;
ABC abc = factory.createABC();
----
+
[TIP] 
====
If your addon uses a container that does not support "@Inject" annotations, services such as the `ABCFactory` may also be 
accessed via the `AddonRegistry`:
----
Imported<ABCFactory> imported = addonRegistry.getServices(ABCFactory.class);
ABCFactory factory = imported.get();
----
==== 
Creating a new XYZ instance:: 
Causes XYZ to occur
+
[source,java]
----
XYZ xyz = factory.createXYZ();
----
{code}

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira