> -----Original Message-----
> From: [EMAIL PROTECTED]
> [mailto:[EMAIL PROTECTED]]On Behalf Of
> [EMAIL PROTECTED]
> Sent: Monday, December 18, 2000 10:01 AM
> To: JetSpeed
> Subject: Re: docs
>
>
> 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.
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/

> "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.....

>
> > >
> > > We will always need an administration feature even though the
> > > administration
> > > screen is likely to change soon. For this release, I think we
> > > should keep it
> > > as is.
> > >
> >
> > Is the administration going to be working in 1.3a1?
> > If so, what do you mean by changing and how soon? Is it
> changing for 1.3a1?
> >
>
> It will not change before 1.3a1. We'll try to make admin work OK
> for this release. If it's not possible, it'll be mentioned in the
> release notes. It's not a big issue since there're no links to the
> Admin screen right now so people won't test it unless they read the
> documentation...
>
> --
> 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]
>
>



--
--------------------------------------------------------------
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