RE: Font choices

Subject: RE: Font choices
From: "Liz Tam" <ltam -at- ariba -dot- com>
To: "Dana Worley" <dana -at- campbellsci -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 1 Dec 2010 08:48:27 -0800

IMO, the Microsoft style conventions might not be suitable for APIs or other environments where the symbols Microsoft uses as delimiters (angle brackets, square brackets, etc.) have literal meanings. For example, most programming languages use square brackets to indicate arrays. In Un*x shells, angle brackets and pipes (|)direct input and output.

-----Original Message-----
From: techwr-l-bounces+ltam=ariba -dot- com -at- lists -dot- techwr-l -dot- com on behalf of Dana Worley
Sent: Wed 12/1/2010 8:22 AM
To: Roberta Hennessey; techwr-l -at- lists -dot- techwr-l -dot- com
Subject: Re: Font choices

Most (if not all) programmers will be familiar with conventions used for command line syntax:

http://technet.microsoft.com/en-us/library/cc771080%28WS.10%29.aspx

Dana W.

> I want a programmer to be able to glance at it and be able to tell which is
> required and which is optional. As this will be both
> online and hard copy, no color is used.
>
> Is there an industry standard for code examples programmers are familiar
> with?

***************************
Dana Worley
Software Product Manager/Manager, Software Support Group
Campbell Scientific, Inc.
Microsoft MVP, Windows Help
www.jestersbaubles.blogspot.com
www.jestersbaubles.com

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com

---
You are currently subscribed to TECHWR-L as ltam -at- ariba -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ltam%40ariba.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


Follow-Ups:

References:
Re: Font choices: From: Dana Worley

Previous by Author: Re: Fwd: Need help from an Excel guru
Next by Author: RE: Font choices
Previous by Thread: Re: Font choices
Next by Thread: Re: Font choices


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

Sponsored Ads


Sponsored Ads