Re: [Dynapi-Help] About DynAPI portal and documentation project

[Scott A. L. <sc...@sc...>]

I think what Jordan meant was that he's building empty page templates
based on Dan's original Dynamic Duo tutorial, to be used for DynAPI2
documentation.  It's not a bad idea.

I'd like to see a central location for everything too, preferably at
SourceForge.  A 'portal' where the public can get the latest news and
grab documentation and widget sets.

I agree with Tarun, and would like to add that if we are getting serious
about documenting the DynAPI2, we should probably choose a *standard*
format and divide the work up among us.  There's no point in everyone
running off to do their own documentation of the API, and wind up with
four different versions. Maybe we should divide into teams to get the
docs finished.

Once we have the DB up and format decided, I would be happy to see even
only two or three classes and their methods/properties documented each
day. It doesn't have to be done all in one day and it certainly
shouldn't be done in a hurry, IMO.

As an aside, I used to be a copywriter and proofreader, and would be
happy to edit and proof anyone's articles or documentation.

scottandrew

Tarun R Elankath wrote:
> 
> There seems to be a lot of mail flying back and forth about the
> documentation project with seemingly no consensus, about which server should
> be the base and about what version of the API we should document.
> 
> I personally dont see the point of documenting version 1 because
> Dansteinmans site does that fairly well already. DynAPI2 should be the main
> focus here, I believe.
> 
> It would be a fairly good idea to put DynAPI docs at sourceforge itself,
> since it makes more sense to have everything at one place.
> 
> I wasnt  aware that sourceforge offers MySQL support. The only disadvantage
> is that sourceforge offers just PHP support, not Serlvet,JSP or Perl
> support.
> 
>  But I guess Rainwater is correct in saying that the advantage(s) in having
> everything at one place, exceeds the advantage(s) of having the freedom of
> development platform..
> 
> That also means that some of us will have to learn PHP  :-)
> 
> ( I apologize for submitting this message to the help list as it technically
> should go into open discussion, however it seems that no-one is on the
> open-discussion mailing list)
> 
> ----- Original Message -----
> From: "Robert Rainwater" <rai...@us...>
> To: "Robert Rainwater" <dyn...@li...>
> Sent: Friday, October 27, 2000 5:46 PM
> Subject: Re[3]: [Dynapi-Help] Agree with Jack
> 
> >
> > Also, I would also be interested in creating a sort of DynAPI portal at
> > dynapi.sourceforge.net that could have the latest news/info on the
> > dynapi.  Plus have a section for peoples personal contributions
> > (widgets, etc).  And of course have the documentation there as well.
> > As it is now, there is not a central place for this type of information.
> >
> > Later,
> > Robert <rai...@us...>
> >
> >
> > _______________________________________________
> > Dynapi-Help mailing list
> > Dyn...@li...
> > http://lists.sourceforge.net/mailman/listinfo/dynapi-help
> >
> 
> _______________________________________________
> Dynapi-Help mailing list
> Dyn...@li...
> http://lists.sourceforge.net/mailman/listinfo/dynapi-help