I'm wondering about the most polite way to list code when you need
help. Before hyperlinks, you had to inline all the code. But I think
that hampers readability of the document as a whole. I am starting to
prefer a markdown way of writing my emails, putting links to relevant
source files instead of inlining them, like so:

    Which is perplexing because
           [the test
file](http://gitorious.org/project_factor/data-maker/blobs/master/field/from-format/from-format-tests.factor)
      has USING: data-maker.field.from-format ... ;
    and data-maker.field.from-format [defines
next](http://gitorious.org/project_factor/data-maker/blobs/master/field/from-format/from-format.

I think that makes for a much more digestible email than pasting in
lines of code, especially when the source file gets above 10 lines.

What do you think?

------------------------------------------------------------------------------
Download Intel® Parallel Studio Eval
Try the new software tools for yourself. Speed compiling, find bugs
proactively, and fine-tune applications for parallel performance.
See why Intel Parallel Studio got high marks during beta.
http://p.sf.net/sfu/intel-sw-dev
_______________________________________________
Factor-talk mailing list
Factor-talk@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/factor-talk

Reply via email to