Skip to content

Commit

Permalink
Update grammar and clarity
Browse files Browse the repository at this point in the history
  • Loading branch information
lincolnthree committed Nov 10, 2014
1 parent 7f1d5d0 commit cace3b7
Showing 1 changed file with 12 additions and 9 deletions.
21 changes: 12 additions & 9 deletions tutorials/forge-hol/docs/chapters/introduction.adoc
Expand Up @@ -3,9 +3,11 @@

=== JBoss Forge

It's not so easy to explain what Forge is in a few paragraphs.
That is why we will re-use the introduction from http://www.amazon.com/Continuous-Enterprise-Development-Andrew-Rubinger/dp/1449328296[Continuous Enterprise Development] book:
It's not so easy to explain what Forge is in a few paragraphs, so we will quote the
introduction from http://www.amazon.com/Continuous-Enterprise-Development-Andrew-Rubinger/dp/1449328296[Continuous Enterprise Development] (a book):

[quote, Continuous Enterprise Development]
____________________________________________________________________
If you’ve spent any time developing Java EE–based projects (or any nontrivial application,
for that matter!), you’ve likely invested a good amount of energy in creating the
project layout, defining dependencies, and informing the build system of the relevant
Expand All @@ -25,28 +27,29 @@ Because Forge is built atop a modular, plug-in-based architecture, it’s extens
tasks that may be specific to your application.
Overall, the goal of Forge is to ease project setup at all stages of development, so we’ll
be employing it in this guide to speed along the construction of our examples.
____________________________________________________________________

=== What's this HoL about?
=== What's this lab about?

This hands-on lab (HoL) should give you a good practical introduction to http://forge.jboss.org[JBoss Forge]. You will first install JBoss Forge, use it and then develop and entire Java EE application and create addons to extend the capabilities of Forge. Forge can either be used with an IDE, or directly with a command line interface (CLI).
This hands-on-lab (HoL) should give you a good practical introduction to http://forge.jboss.org[JBoss Forge]. You will first install JBoss Forge, use it and then develop and entire Java EE application and create addons to extend the capabilities of Forge. Forge can either be used within an IDE, or directly in the system terminal via a command line interface (CLI).

The idea is that you leave this hands on lab (HoL) with a good understanding of what JBoss Forge is, what it is not, and how it can help you in your projects. Then, you'll have your entire time to investigate a bit more and, hopefully, http://forge.jboss.org/community[contribute].
The idea is that you leave this hands on lab (HoL) with a good understanding of what JBoss Forge is, what it is not, and how it can help you in your projects. Then, you'll be prepared to investigate a bit more and, hopefully, http://forge.jboss.org/community[contribute].

NOTE: Get this tutorial from https://github.com/forge/docs/tree/master/tutorials/forge-hol

=== How does this HoL work?
=== How does this lab work?

You have this material in your hands (either https://github.com/forge/docs/blob/master/tutorials/forge-hol/forge-hol.pdf[electronically] or printed) and you can now follow it step by step or choose any section "à la carte". The structure of this hands on lab is as follow :

- _Installing Forge_ : in this section you will install JBoss Forge, either on a standalone mode, or with JBDS (JBoss Developer Studio)
- _Using Forge_ : in this section you will play with Forge, create a project, add entities, scaffold a JSF web application, REST endpoints, generate some Arquillian tests and deploy them on WildFly
- _Developing Forge_ : in this section you will quickly create a full web application, build extensions, and add these extensions to the application
- _Developing Forge_ : in this section you will quickly create a full web application, build forge addons, and use these addons in the application

If you have Forge already installed, just go to the _Using Forge_ section and start using it. If you already know JBoss Forge a bit, jump to the section on _Developing Forge_ and start hacking some addons. This "à la carte" mode allows you to make the most of this 3 hours long hands on lab.
If you have Forge already installed, skip to the _Using Forge_ section and start using it. If you already know JBoss Forge a bit, jump to the section on _Developing Forge_ and start hacking some addons. This "à la carte" mode allows you to make the most of this 3 hours long hands on lab.

=== What do you have to do?

This hands on lab should be as self explanatory as possible. So your job is to follow the instructions by yourself, do what you are supposed to do, and do not hesitate to ask for any precision, that's why the team is here for. Make sure you have the needed software installed (see below) and be ready to get some fun.
This lab should be as self explanatory as possible. So your job is to follow the instructions by yourself, do what you are supposed to do, and do not hesitate to ask for any clarification or assistance, that's why the team is here. Make sure you have the required software installed (see below) and be ready to have some fun!

=== Software requirements

Expand Down

0 comments on commit cace3b7

Please sign in to comment.