David Sean Taylor wrote:
> 
> > David Sean Taylor wrote:
> > >
> > > Raphael Luta wrote:
> > > >
> > > > > Im concentrating on converting my Developers Guide to 1.3a1. I
> > > > think I can
> > > > > finish it tomorrow along with
> > > > > the top tasks below 'Working documents'
> > > > >
> > > > > Also think we should regenerate the javadocs and put them on
> > > > the website.
> > > > >
> > > >
> > > > I agree. Should we also put them in the webapp ?
> > > >
> > >
> > > Of course the javadocs can always be built with one easy command.
> > > Its a question of do we want to make the war bigger versus the
> > trade off of
> > > having the javadocs immediately available with the war file. I
> > think that
> > > the javadocs should go into the webapp, since the webapp is really a
> > > starting point for people to start using the system and learn about it.
> > >
> >
> > If you looked at the new default.psml, there's a link on the
> > Jetspeed portlet
> > that goes straight to the website documentation. Of course we can
> > also bundle
> > the docs with the webapp but it is only useful if we distribute a
> > "binary"
> > webapp without the source code.
> 
> Yes Ive seen it. The first link is fine, but the second link goes to a
> directory on the server which is really just the same as the first link. In
> my opinion having a link to a directory on the server is confusing.

That's because there's no index file in this directory. I'll fix this.
In any case we can change the link on the server RSS file and all the jetspeed
webapp distributed will be updated...

> Perhaps we could put a link to the javadocs here. I own a copy of
> Togethersoft, I just generated a combination of UML and Javadocs. Here is a
> link to the javadocs generated for the current branch...
> 
> http://www.bluesunrise.com/jetspeed/javadocs/
> 

These are very nice ! I think you should put a link in the documentation page
to this URL.

> > "binary" webapp without the source code.
> 
> Not a bad idea. Then people can install without the build step.
> You would think that would *really* cut down on the installation
> questions.....
>

Yes, or at least make the questions really simple to answer, you
never know what some users are capable of... ;/

--
Rapha�l Luta - [EMAIL PROTECTED]
Vivendi Universal Networks - Services Manager / Paris


--
--------------------------------------------------------------
Please read the FAQ! <http://java.apache.org/faq/>
To subscribe:        [EMAIL PROTECTED]
To unsubscribe:      [EMAIL PROTECTED]
Archives and Other:  <http://marc.theaimsgroup.com/?l=jetspeed>
Problems?:           [EMAIL PROTECTED]

Reply via email to