Hello, I think we should have the comments be parsed out for the documentation. This will simplify documenting and allow the documents be most up to date. When you seperate your code and documentation, they will eventually (like how it is now) become different unless you are really on top of it. So when you make a change to the code, you can also quickly change the documentation. For displaying the documentation, I agree that we should have the organization (menu, tree, roll over, sliding, what ever ...) with DynAPI. At least something that shows a little of DynAPI off. The Documentation should be compiled automatically, so we can make a server side script that compiles it *** OR *** we can make a JAVA program (so it will work on many platforms) and put together something like jsdoc (to make it similar to javadoc). I know this will be a different project, but hey I'm willing to start a new project on SourceForge if it will help the DynAPI documentation. Documentation is VERY important, and if we want to make DynAPI accepted by many developers then we need LOTS of documentation, so we need it easy to make good documentation of API's. What I did for my java project is that you can integrate the jre with your java program, this made it like a native C program. I used the FREE version of InstallAnywhere by Zerog at www.zerog.com. So people wouldn't have to worry about the jre with this. We could make this a command line base (like how javadoc is) or a GUI base application. This program will parse out the comments from the code and also write comment free code (so it will load up faster) and create the HTML/DynAPI documentation. A systems administrator could setup their server to use this program to automatically generate daily documentation. This is just some ideas, does anyone want to go ahead with jsdoc? I can do the java coding but it wouldn't hurt if I could get some help. Thanks, Matt
_______________________________________________ Dynapi-Dev mailing list [EMAIL PROTECTED] http://www.mail-archive.com/[email protected]/
