Can you add the category stuff or should I do it? We need:
- a new property 'Category' for 'CustomFunctionSetAttribute' - changes to the function index to split functions by category - maybe we should place this information on each function's reference page Jarek ----- Original Message ----- From: "Ian MacLean" <[EMAIL PROTECTED]> Cc: "Jaroslaw Kowalski" <[EMAIL PROTECTED]>; <[EMAIL PROTECTED]> Sent: Wednesday, December 10, 2003 3:30 PM Subject: Re: [nant-dev] Naming of documentation files > Good work on the userdoc stuff for functions Jarek. I just built after > syncing your checkins. It looks great - we just need to fill those doc > comments in now. I can see that a category is needed though - that > index page is looking pretty crowede already. > > Ian MacLean wrote: > > > The category could also be implemented using a tag in the xml > > comments. The advantage with using an attribute property is that you > > can get the compiler to force the property to be set. Not too bothered > > either way. > > > > Ian > > > > Jaroslaw Kowalski wrote: > > > >>> The next thing I'll look at is namespace support which would be > >>> somthing > >>> like : > >>> > >>> [CustomFunctionSet(NameSpaceUri="somenamespace", prefix="foo" )] > >>> > >>> > >> > >> > >> I suggest, that we included something like a category/description which > >> would be used to generate > >> the documentation. > >> > >> [CustomFunctionSet(NameSpaceUri="somenamespace", > >> Prefix="", > >> Category="String Functions")] > >> > >> [CustomFunctionSet(NameSpaceUri="somenamespace", > >> Prefix="date", > >> Category="Date/Time Functions")] > >> > >> We could generate the "Function Index" page where functions would be > >> groupped by Category. > >> > >> We'd have: > >> > >> String Functions: > >> > >> length | description for length() > >> substring | description for substring() > >> startswith | description for length() > >> > >> Date/Time Functions: > >> > >> now | description for now() > >> > >> and so on... What do you think? > >> > >> Jarek > >> > > > > > ------------------------------------------------------- > This SF.net email is sponsored by: SF.net Giveback Program. > Does SourceForge.net help you be more productive? Does it > help you create better code? SHARE THE LOVE, and help us help > YOU! Click Here: http://sourceforge.net/donate/ > _______________________________________________ > nant-developers mailing list > [EMAIL PROTECTED] > https://lists.sourceforge.net/lists/listinfo/nant-developers > ------------------------------------------------------- This SF.net email is sponsored by: SF.net Giveback Program. Does SourceForge.net help you be more productive? Does it help you create better code? SHARE THE LOVE, and help us help YOU! Click Here: http://sourceforge.net/donate/ _______________________________________________ nant-developers mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/nant-developers
