forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Gav...." <brightoncomput...@brightontown.com.au>
Subject RE: [jira] Updated: (FOR-639) define terminology for the various aspects of Dispatcher
Date Tue, 04 Apr 2006 14:23:23 GMT


> -----Original Message-----
> From: David Crossley [mailto:crossley@apache.org]
> Sent: Saturday, 1 April 2006 9:34 AM
> To: dev@forrest.apache.org; brightoncomputers@brightontown.com.au
> Subject: Re: [jira] Updated: (FOR-639) define terminology for the various
> aspects of Dispatcher
> 
> David Crossley wrote:
> > Gav.... wrote:
> > > Ok, Paul has also mentioned this so needs sorting, I'll see what I can
> come
> > > up with in the next day or two.
> > >
> > > What we have so far it terms of Dispatcher Docs published:-
> > >
> > > dispatcher.html
> > > howto-structurer-install.html
> > > howto-dispatcher-quickstart.html
> > > howto-structurer-dsl.html
> > > howto-structurer-contracts.html
> > >
> > > The howto-structurer-install.html is actually describing how to
> > > Install the "Dispatcher" so I think should be renamed to avoid
> > > Further confusion.
> >
> > Yes, i have wondered about that too.
> > Today i will 'svn move' the documents,
> > amend all the links and references, and
> > create .htaccess redirects for the website.
> 
> Okay moved the install document. The others have
> relevant names. Thanks to site.xml did not need
> to change any links.
> 
> However i wonder do we really need that "install"
> document anymore. It was for the old versions of
> the plugins and recently evolved to describe the
> current work. Its information seems to be contained
> in the Quickstart.

I agree, the Quckstart is a replacement for the Install Document
So Install should go.

> 
> > > The howto-structurer-dsl is out of date and contains incorrect
> > > Contract examples. Is there an upto date version of this or
> > > Shall I attempt to correct the examples given.
> 
> No other version. Need to update it. As above it
> probably used to refer to the old plugins. Now we
> need to encourage people to use the current Dispatcher.
> IMO there is no need to try to describe old (x2) and new.

Agree.

> 
> > > 	Also, I would like an example of what is meant by
> > > "Domain Specific" in this context  (of -dsl)
> 
> That is probably a common term. Basically means
> that the "programming language" is only relevant to
> this domain (the structurer part of the dispatcher).

Thanks for that explanation.

(I thought I replied to this earlier, but it seemed to have been eaten up in
the ether.

Anyway, getting back on track, although the Glossary Plugin has been made
and nearly ready for use - and its first intended use will be to add
Dispatcher related terminology for it, I have also been working on a howto
version as I feel this may still have a place on the site and can contain
more examples, drawings maybe, etc than the Glossary version should.

So I have created a basic skeleton so far and can be seen at
http://apache.minitutorials.com/howto-dispatcher-terminology.html

Please let me know if the terminology headings are correct and if there is
any terminology that is missing that can be added.

I would also like to start implementing descriptions/explanations from the
post at http://marc.theaimsgroup.com/?l=forrest-dev&m=112596689428172&w=2

I feel though that because it was posted in September last year, that this
too is now out of date. I will start to do what I can, but can devs please
contribute by posting what they can in terms of upto date explanations of
the terminology headings.

I will then incorporate these into the document and upload it when finished.
If possible Id like to finish it by the weekend, working in conjunction with
the glossary files which may take a little longer.

Thanks

Gav...

> 
> -David
> 
> 
> --
> No virus found in this incoming message.
> Checked by AVG Free Edition.
> Version: 7.1.385 / Virus Database: 268.3.4/299 - Release Date: 31/03/2006



Mime
View raw message