I can't stress this enough, but documentation is *very* important in large projects such as Source, one shouldnt try to figure out what all the code does, considering how it's not even possible to do so since most of the code isnt even public.
Documenting the code ourselves would be an interesting idea, however it is a long task, and as such should be very well organized. Since i dont use the Source SDK, i probably wont help, so good luck to everyone. On Tue, Jan 13, 2009 at 5:31 PM, Willem Engel <[email protected]> wrote: > Yes, time to put some sense back into this thing. Does anyone know of a > system that would allow multiple persons to add comments to code without > modifying the code itself? I imagine something like a wiki based on a > class-diagram of the current code. We might even be able to add it to a > section on the valve dev wiki? > Commenting the code itself would require the lot of us to share a > subversioning system of some kind. > > ZuM wrote: > > Good to see that someone on this list isn't flaming like some above. > > > > Now onto the topic, James, none that i know of is doing that. > > > > 2009/1/13 James Luzwick <[email protected]> > > > >> On the topic of design documents. Does anyone know if there has been a > >> push > >> by anyone in particular to create javadoc-like doxygen comments for all > the > >> code in the SDK? If there is some person in general working on it, I > would > >> love to add to it as I program and figure out more about the SDK. > >> > >> I think this would be a good idea as it could easily be exported to > HTML. > >> _______________________________________________ > >> To unsubscribe, edit your list preferences, or view the list archives, > >> please visit: > >> http://list.valvesoftware.com/mailman/listinfo/hlcoders > >> > >> > > _______________________________________________ > > To unsubscribe, edit your list preferences, or view the list archives, > please visit: > > http://list.valvesoftware.com/mailman/listinfo/hlcoders > > > > _______________________________________________ > To unsubscribe, edit your list preferences, or view the list archives, > please visit: > http://list.valvesoftware.com/mailman/listinfo/hlcoders > > _______________________________________________ To unsubscribe, edit your list preferences, or view the list archives, please visit: http://list.valvesoftware.com/mailman/listinfo/hlcoders
