Re: [Asterisk-java-devel] Help Vampires: A Spotter's Guide

[Martin B. S. <ma...@be...>]

Hello folks,

I've done an initial FAQ with some common questions I think we get. I went
back through the -users list in order to generate the questions and some of
the responses too. I'm still slightly new to Maven -- is there any way to
build the site without all of the compilation and tests being run before
that?

Also, I found an erroneous HTML paragraph tag in one of the other documents,
and made a little sentence above the first tutorial on the tutorial page. I
think people often skip the tutorial page once they see it starts with
FastAGI, and they don't know what they are looking for is just below that
section.

Unfortunately, I fought and fought with APT to get it to correctly generate
internal anchors on the tutorial page; I referred to
http://maven.apache.org/doxia/format.html, but their example does not seem
to work, so I ended up working around it by directly linked to the anchors
non-automagically. I'd love if it someone could figure that one out --
Google showed me that it had been a bug in the past, and a commonly-reverted
one that shows up again for Apt. They claim it is fixed at the moment, but I
have my doubts after my episode with it :).

Finally, I toyed with (but didn't) re-arranging the lefthand side menu, to
make the tutorials more often (I think our biggest question on the list is a
request for code snippets and examples), but I couldn't decide on any
change, so I left it alone. I also toyed with modifying the main "Home" page
-- I think it might be good to combine the top little paragraph that starts
with "The Asterisk-Java package..." and the "status" section, so that there
aren't so many single-sentence paragraphs. I think people get lost in that
front part and don't read/use it (a lot of newcomers don't understand the
differences between the AMI/AGI parts of Asterisk, and that first paragraph
does kind of try to explain it briefly).

I've read that designing sites and pages on the www is a lot like being a
billboard designer -- you're trying to hit your users as they go by at
highway speeds ;).

Cheers,

Martin


> -----Original Message-----
> From: ast...@li... 
> [mailto:ast...@li...] On 
> Behalf Of Stefan Reuter
> Sent: Wednesday, March 12, 2008 7:27 PM
> To: ast...@li...
> Subject: Re: [Asterisk-java-devel] Help Vampires: A Spotter's Guide
> 
> Yep I think thats a very good idea. And we should put a link 
> to them at a very prominent place.
> Feel free to add an FAQ document to the site directory in 
> svn. The http://asterisk-java.org/development/ site is 
> generated automatically each night so it will show up automatically.
> 
> Thanks
> Stefan
> 
> Martin Smith wrote:
> > Thought it was very relevant :) I caught the post on your 
> blog via my 
> > RSS reader before I saw your reply here...
> > 
> > On a serious note, I'm thinking of a list of frequently asked 
> > questions that might go into the Maven-generated site; I 
> can already 
> > think of 3 or
> > 4 we see over and over. Do you think there's a better place 
> for them?
> > Opinions, comments, rants? :)
> > 
> > Martin Smith, Systems Developer
> > ma...@be...
> > Bureau of Economic and Business Research University of Florida
> > (352) 392-0171 Ext. 221
> > 
> >  
> > 
> >> -----Original Message-----
> >> From: ast...@li...
> >> [mailto:ast...@li...] 
> On Behalf 
> >> Of Stefan Reuter
> >> Sent: Monday, March 10, 2008 11:19 PM
> >> To: ast...@li...
> >> Subject: Re: [Asterisk-java-devel] Help Vampires: A Spotter's Guide
> >>
> >> Martin Smith wrote:
> >>> I love this article:
> >>> http://www.slash7.com/pages/vampires
> >> Thanks! With the guide at hand I even spotted some vampires out of 
> >> the IT sphere in real life^^
> >>
> >> =Stefan
> >>
> >>
> >>
> > 
> > 
> ----------------------------------------------------------------------
> > --- This SF.net email is sponsored by: Microsoft Defy all 
> challenges. 
> > Microsoft(R) Visual Studio 2008.
> > http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
> > _______________________________________________
> > Asterisk-java-devel mailing list
> > Ast...@li...
> > https://lists.sourceforge.net/lists/listinfo/asterisk-java-devel
> 
> 
> --
> reuter network consulting
> Neusser Str. 110
> 50760 Koeln
> Germany
> Telefon: +49 221 1305699-0
> Telefax: +49 221 1305699-90
> E-Mail:  ste...@re...
> Jabber:  ste...@re...
> WWW:     http://www.reucon.com
> 
> Steuernummern 215/5140/1791 USt-IdNr. DE220701760
> 
>