Table Of Contents
This appendix provides lists of useful websites and e-mail aliases to help writers and editors track, research, and write Cisco documentation. This appendix also contains a list of websites for information about Cisco style, templates, and so forth. In addition, there are process and procedure tips to help you work more efficiently.
This appendix includes the following sections:
You can find the Cisco documentation groups at the Cisco Documentation Groups' internal home page at the following website:
Note There is also a link to the New Hire Information page from this site.
Cisco Connection Groups
You can find the Cisco.com groups at the following websites:
•Cisco.com group home page
•Central Engineering Services documentation tools related to publishing (contains information about CCIM, doc bugs, and online help)
•Central Publishing Services documentation resources related to illustrations and documentation production
•Documentation Schedule Database (DSD)
•Publishing Processes and Policies
You can use the following e-mail aliases to answer some of your documentation questions:
Visit http://www-mailer.cisco.com/mailer.html (Mailer home page) for more information about aliases.
You can find engineering information at the following websites:
•Central Engineering Services documentation tools related to publishing (contains information about CCIM, doc bugs, FrameMaker templates, and online help)
•Cisco Software Release Operations
•IOS Software Release Operations
•Project Data System (IOS features)
•Release Operations TrainTracker
•Corporate Defect Tracking (DDTS) home page
•Engineering@Cisco home page
•Engineering Document Control System (EDCS) (engineering specifications)
•Cisco IOS software image-naming conventions
Documentation Part Numbers
Customer documents are assigned unique numbers that facilitate customer ordering, product kitting, and internal project tracking. Any customer document other than an embedded online help file requires a documentation part number.
Documentation part numbers are generated by the Cisco Document Control team and administered by means of the Document Schedule Database (DSD).
Note For the most recent information about documentation part numbers, see the following websites:
•Document Control team at http://wwwin.cisco.com/ios/spd/kmd/cps/documentcontrol/.
•DSD at http://wwwin.cisco.com/cgi-bin/it/cdc/dsd/dsd_login.pl and click the Download DSD User Guide link.
Reference Material for Writers and Editors
As you work on Cisco documentation, you should find the following style, tool, and technical references to be helpful.
Topic Document Title
Cisco style and tool references
•Cisco Distribution Team home page and change-request form to submit changes to the style guide
•FrameMaker Templates Handbook and other template resources
Documentum Web Publisher (http://ecmx-wp.cisco.com/wp/), under Sites (Web Cabinets)/TD/docs/general/TD_FM_Templates
•The Cisco Marketing Style Guide
•Cisco Technical Documentation Style Guide (latest version of style guide)
•Guidelines for Writing Single-Sourced Cisco IOS Documentation
•Command Reference Tagging Guidelines for the Cisco IOS Doc Set
•Task Table Tagging Guidelines for FrameMaker
•Direct access to Cisco Technical Documentation
Note The above URL points to the Product Selector Application (PSA), where customers can find all Cisco technical documentation. Feel free to use this URL in prefaces, release notes, and other docs where you need to provide a general link to Cisco technical documentation.
Other style and tool references
•The Chicago Manual of Style
•IEEE Transactions, Journals, and Letters: Information for Authors (p. 4)
•The Elements of Style
•Merriam-Webster's Collegiate Dictionary
•Microsoft Manual of Style for Technical Publications
•Online writing resources
•Words into Type
Cisco technical references
•Cisco Industry Standards and Regulations Library
•Cisco Legal Services
Contains information on corporate affairs, licensing and technology, intellectual property, regulatory affairs, privacy, and more.
•Networking Master Terminology List
Other technical references
•The Authoritative Dictionary of IEEE Standards Terms
•Computer dictionaries and glossaries
•IBM Dictionary of Computing
•Microsoft Computer Dictionary
•Newton's Telecom Dictionary (published annually)
•Tom Sheldon's Linktionary.com