Coffeehouse Post

Single Post Permalink

View Thread: Rich text source files.
  • User profile image

    Why are we still stuck with using plain vanilla (albeit Unicode) text as source files?
    What if I want to include tables in my comments, underline something, put something else in bold or even highlight a paragraph and change the color? Or maybe put an expainatory picture in there? Or a hyperlink? And while I'm at it - save the whole thing as XML instead of a text file?

    Or maybe I can, I just don't know about it?

    There has been much discussion over the years
    about how to document code. And how to keep code
    and documentation in sync. Javadoc and XML comments
    are a step in the right direction. And nowadays
    we've got syntax color coding to help us in our
    daily work. I think it would rock if I didn't have to have one set of source files, and one set of Word-files for documenation.

    Ofcourse there is a very real risk of vendor or format lock-in. But let's assume for a second that everyone gets along and uses XML, RTF or something when saving the files. Couldn't this be both convenient and increase productivity?