On Fri, Feb 26, 2010 at 11:28:43AM -0500, Terrence Brannon wrote: > 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:
I'm not sure that Markdown syntax really adds anything. I'd just put the links inline, like so: http://paste.factorcode.org/paste?id=1042 Note the use of the factorcode.org pastebin, which produces nice short URLs. [BTW: the spambots have found their way around the reverse-psychology captcha. See http://paste.factorcode.org/paste?id=1494 .] But for short enough code samples (less than ten lines or so), I think it's fine to include code inline; code that follows the Factor style guidelines should fit nicely in a terminal window. Then again, I read email in a fixed-width font; perhaps people who read mail via the Web will feel differently. Miles -- Love makes you do the wacky. -- Willow ------------------------------------------------------------------------------ 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 [email protected] https://lists.sourceforge.net/lists/listinfo/factor-talk
