From: Ian S. <ian...@st...> - 2003-01-21 17:14:10
|
> -----Original Message----- > From: Amitha Perera [mailto:pe...@cs...] > Sent: Tuesday, January 21, 2003 4:55 PM > To: Geoffrey Cross > Cc: vxl...@li... > Subject: Re: [Vxl-users] Examples gevd contour > > > On Tue 21 Jan 2003, Geoffrey Cross wrote: > > However gel is 'development code', so there shouldn't be > anything wrong > > with having broken / incomplete / obsolete / old / bad / ... code in > > there. > > > > I'm not sure we make it clear enough to average users that > code outside > > of the core is not 'vxl-supported' code. Maybe we should even > > discourage discussions of this code here, and just point > people to the > > relevant developers. Perhaps we should be using the sourceforge > > trackers and bug-reporting more extensively. The SF trackers were massively unpopular with the VXL community, when they were set-up. I also don't think that resurrecting them would solve the underlying problem, which is distinguishing well-documented, well-supported contrib code from libraries like gevd. > > Not "vxl-supported" does not mean "broken" and "avoid using". Some > code in the contrib directories, e.g. rpl stuff and some (all?) of the > mul stuff are "vxl quality", and simply need widespread use before > moving into the core. If we give the impression that the contrib code > is broken, no-one is going to try it, and therefore nothing will ever > get added to the core, and the contrib code will not harden. > > However, it may be useful to mark some libraries, such as gevd, as > broken or incomplete, and list possible contact people. > > Actually, I think it would be good to have contact people for each > contrib library. I support Amitha's suggestion of documenting the state of each library. The introduction_doxy.txt file in each library would be a good place to comment on the code's quality. Well documented libraries (like those in mul :-) implictly state their quality by their documentation, so perhaps only poor-quality libraries need an explicit comment "Warning: This library is an uncompleted port, is unsupported, and not used very much." If people want me to, I would be prepared to make sure that all libraries have at least some sort of comment, and contact info in their introduction_doxy.txt file. Ian. |