You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@avalon.apache.org by si...@avalon.apache.org on 2004/02/26 22:16:58 UTC
[Apache Avalon Wiki] Updated: AvalonForBeginners
Date: 2004-02-26T13:16:53
Editor: AaronFarr <fa...@apache.org>
Wiki: Apache Avalon Wiki
Page: AvalonForBeginners
URL: http://wiki.apache.org/avalon/AvalonForBeginners
putting together an outline -farra
Change Log:
------------------------------------------------------------------------------
@@ -1,22 +1,45 @@
= Avalon Beginners Guide =
-You should start by reading [http://avalon.apache.org/doc/index.html Avalon's documentation]. Start with the [http://avalon.apache.org/developing/index.html Developing guide]. Although the Developing guide is somewhat dated, it's important to note the overall view of concepts relating to component, component control, and how components interact with their surroundings (Work/Role Interfaces, etc). It's also recommended that you read the related documents, such as the [http://www.laputan.org/drc/drc.html IoC] and [http://www.research.ibm.com/hyperspace/MDSOC.htm SoC] pattern documents. Some of the Avalon docs are old/confusing. If these docs are confusing, please read DocumentationCaveats node. We'll try to put things you should watch out for in there.
-== Tutorial, or here's where to start coding ==
-From there, download and install the [http://avalon.apache.org/merlin/ Merlin container], and read the [http://avalon.apache.org/merlin/starting/index.html introductory documentation].
+We're preparing a new beginners guide to Avalon that will be located here in the wiki. It will involve articles describing Avalon and a number of tutorials and HOWTO's. The format is still being worked out, so feel free to edit this page and add something to the outline. You might also want to add a request to [http://nagoya.apache.org/jira/secure/BrowseProject.jspa?id=10420 JIRA].
-Need more here about creating/building.
-
-There is a [http://www.apache.org/~mcconnell/template/ template] for creating components put together by Stephen McConnell (Grab the latest one?). It outlines a project structure (insert more notes about it here, possibly create a new wiki page).
-
-== Avalon Beginner Gotchas/FAQ ==
-1) '''Why does Merlin interrupt the deployment of my component ? '''
-
-Merlin (builds later than Jan 5, 2004) has a mechanism by which if the component takes too long to deploy, it will interrupt its deployment and move on. If your component takes a long time to initialize and deploy, use the deployment-timeout parameter in kernal.xml. Refer to: http://avalon.apache.org/merlin/meta/kernel/parameters/index.html
-
-
-=== I get an error saying "No Goal \[avalon:meta\]" ===
-The two plugins need to be added to you [MAVEN-HOME]/plugins directory. The plugins are shipped with the Merlin binary distribution and include:
-avalon-meta-plugin-[VERSION].jar
-merlin-plugin-[VERSION].jar
-
-(Thanks Steve)
+= Outline =
+ I. Overview of Avalon
+ A. Purpose and Mission
+ A. Common terms and other preliminaries
+ A. Product Overview
+ I. Basic Examples of Writing Components (use Fortress or Merlin?)
+ A. Simple Lifecycle Example
+ A. Simple ServiceManager Lookup Example
+ A. ...
+ I. A More Complete Example: Simple Web Server (parts I and II)
+ A. See what Timothy has in store
+ I. Avalon in various environments
+ A. Standalone
+ A. Servlets
+ A. Avalon and J2EE
+ I. Playing Nice with Avalon
+ A. Converting between Fortress/Phoenix to Merlin
+ A. Avalon and Pico/Spring
+ I. Advanced Topics
+ A. Merlin Facilities
+ A. Writing your own container
+ A. Some other stuff
+
+'''Notes:'''
+ * need to coordinate with other examples, tutorials, etc.
+ * The Merlin Tutorials
+ * Timothy's Web Server Tutorial
+ * Aaron's Mutual Tutorial
+ * The Developing With Avalon paper
+ * Is the wiki the right place for this? Thoughts?
+
+= Related Documentation =
+In lieu of our yet-to-be-finished beginner's guide, you make want to check out the following documentation. Some of it may be dated.
+ * Avalon Documentation Section: http://avalon.apache.org/doc/index.html
+ * Developing With Avalon: http://avalon.apache.org/developing/index.html
+ * Getting Started With Merlin: http://avalon.apache.org/merlin/starting/index.html
+ * Merlin Template : http://www.apache.org/~mcconnell/template/
+ * IoC Article: http://www.laputan.org/drc/drc.html
+ * SoC Article: http://www.research.ibm.com/hyperspace/MDSOC.htm
+ * Avalon Mutuals Example: http://www.jadetower.org/spire/mutuals/
+ * Avalon DocumentationCaveats
---------------------------------------------------------------------
To unsubscribe, e-mail: cvs-unsubscribe@avalon.apache.org
For additional commands, e-mail: cvs-help@avalon.apache.org