From: Vincent M. <vm...@oc...> - 2001-08-17 15:14:50
|
I will divide T7 in several steps to make it more clear : T7A - add javadoc to all code *where needed* (I put "where needed" especially for Steve and Tim). T7B - add version number to sources (@version @version@) T7C - add packages.html to each package T7D - add overview.html Do we agee on that ? To answer Tim and Steve, I think T7C and T7D are more important than T7A and are absolutely needed. Also do remember that a lot of persons look at the javadoc but *not* at the source code (they just have the runtime jar and go to the web site to look at the javadoc usually). -Vincent ----- Original Message ----- From: "Tim Mackinnon" <tim...@po...> To: <moc...@li...>; <moc...@li...> Sent: Thursday, August 16, 2001 11:32 AM Subject: Re: [Mockobjects-java-dev] [Proposal] List of tasks for release 0.02 > T7 is a task we need to make sure is treated properly! I dont believe in > java doc - its an excuse to write bad code or a way of creating work for > yourself (it is useful however if there is no source with your project > but this doesnt affect us...) The better fix is to name things paoperly > om to write better tests. Can this task just be to identify which > classes need javadoc? My claim is that with T1-4 we shouldnt need any. > > tim > > Vincent Massol wrote: > > > From: "Vincent Massol" <vm...@oc...> > > To: <moc...@li...> > > Subject: [Mockobjects-java-dev] [Proposal] List of tasks for release 0.02 > > Date: Wed, 15 Aug 2001 15:14:15 +0100 > > > > Here is a list of tasks that I propose for Release 0.02. Can you please > > state your agreement and others that would like to see. I'll wait for your > > approval before entering them in the todo page : > > > > T1 - [doc] What are MockObjects? > > T2 - [doc] Difference between MO and Stubs ? > > T3 - [doc] Goal page that explains short term and long term goals of the > > project > > T4 - [doc] Coding conventions (in a "Developer" menu) > > T5 - [doc] Features page > > T6 - [doc] Release process page (in a "Developer" menu) > > T7 - [code] add javadoc to all code where needed + add version number to > > sources (@version @version@) + packages.html + overview.html > > T8 - [code] Code aligned with coding conventions (and MO naming conventions > > already present on the web site) > > T9 - [build] finalized build process (still need to finalize directory > > structure + manage examples + manage extensions) > > > > These are the "mnimum" set of task that is can we before the release 0.02. > > > > Tell me also if you wish to volunteer for a given task. There can be several > > persons volunteering for the same task. > > > > I volunteer for T2, T4, T6, T9. > > > > Thanks > > -Vincent > > > > > > _______________________________________________ > > Mockobjects-java-users mailing list > > Moc...@li... > > http://lists.sourceforge.net/lists/listinfo/mockobjects-java-users > > > > > > _______________________________________________ > Mockobjects-java-dev mailing list > Moc...@li... > http://lists.sourceforge.net/lists/listinfo/mockobjects-java-dev > |