RE: code examples

Subject: RE: code examples
From: Sanjay Srikonda <SSrikonda -at- invlink -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 19 Dec 2000 14:40:34 -0500

I've used a different technique as well as labeling the code. If the help
is to be viewed on a static system (one that does not change from view to
view on an end-user's system), I use "" around code and also put it in a
different font. Usually I use courier to make the quoted code stand out.
Also, in the "Conventions" section of the manual is usually a place where
you explain why certain text is boldfaced, highlighted, in courier, etc.
But, that's just what I do.


while your question is highly contextual, a quick answer is label the code
as appropriate.

If you are showing a code fragment to exemplify some function use or
construct, then you probably don't need to label it as coming from a larger
function, etc. However, if you need to provide some context for the example
code to make sense, then you should label it. Labels make sense when they
add something (which may include the ability to search for the code example
by label). Otherwise, they are only there to satisfy our anal desires to
categorize.

walden
<snip>

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Develop HTML-based Help with Macromedia Dreamweaver! (STC Discount.)
**NEW DATE/LOCATION!** January 16-17, 2001, New York, NY.
http://www.weisner.com/training/dreamweaver_help.htm or 800-646-9989.

Take XML and Tech Writing courses online! Our instructor-led courses
(4-6 hrs/wk) give you "hands on" experience at your convenience. STC members
get 20% off! http://www.online-learning.com/index.html.
---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.


Previous by Author: RE: TW jobs-how to choose-Now decided!!
Next by Author: RE: Turning down an offer you can't refuse
Previous by Thread: RE: code examples
Next by Thread: Re: code examples


What this post helpful? Share it with friends and colleagues:


Sponsored Ads