TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
On Fri, Jul 23, 2010 at 11:16 PM, David Neeley <dbneeley -at- gmail -dot- com> wrote:
> Lyx automatically and rapidly renumbers footnotes
> when pieces of the doc are rearranged or new material is inserted. One
> more thing the writer doesn't have to worry about.
I don't think the references that Heather mentioned are footnotes, but
external reference documents like standards and the like.
For instance, at the beginning of a development document, we'd list a
table of references:
[1] IEEE 802.11n draft spec {url}
[2] Internal SW development process {location}
[3] Grocery list from your mother {location}
Somewhere in the documents, or paragraphs would be littered with
phrases built on assumptions based on these specifications: "The
flizbot operates at a maximum gigawatt throughput of x^2/8âab as per
[1]. Check the milk and cookies level in accordance with [3]."
I think Heather was more concerned as to how the references were used.
Based on her example, I think they require more context from the
author before relating them to a reference. However, she did say she
changed the terms, so maybe they worked in those cases. In the
specific sentence, they don't.
In an academic paper, I like the use of superscript to mark endnotes
(not footnotes) that describe the context or link to the reference in
the bibliography. I don't write (-strkethrough-many) any academic
papers, though I've seen references to some style guide for them
that's really popular amongst the labcoats.
Gain access to everything you need to create and publish information
through multiple channels. Your choice of authoring (and import)
formats with virtually any output. Try Doc-To-Help free for 30-days. http://www.doctohelp.com/
LavaCon 2010 in San Diego Sept 29–Oct 2 is now open for registration.
Use referral code TECHWR-L for $50 off conference tuition!
See program at: http://lavacon.org/
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-