Provide a mini-tutorial for utilizing the documentation
I think the way the docs are laid out is pretty logical, but not necessarily intuitive. I see a lot of people give up digging through the index manually and favor the Google route, instead of exterting the extra effort to find exactly what they need from the index.
I forced myself to learn to use the documentation properly after being bitten too many times working off of documentation located via Google which applied to an incorrect IOS version or a dissimilar hardware platform. I put together a short guide to illustrate the strategy I use for navigating the docs to hopefully help others: http://packetlife.net/blog/2010/mar/8/navigating-cisco-documentation/
I have no doubt the documentation maintainers could come up with something ten times more elegant than what I did. Just a short tutorial, maybe five minutes in length, accessible from the main documentation page. "First time using the docs? Read this to get started!" That sort of thing.
Re: Provide a mini-tutorial for utilizing the documentation
We applaud you! You wrote up a very clever, resourceful strategy for finding the correct documentation on Cisco.com. To be honest, writers do drill down exactly as you've described to find docs ourselves. You've turned on a light bulb in my head about how that process can be useful for others navigating for particular docs on Cisco.com. Your three examples are very apropos and highlight three areas where customers can stumble when looking for docs. I like your outlining the paths to docs given what sort of Cisco IOS feature, switch, or command you’re looking for. We can’t always control how navigation is masterminded on Cisco.com but we’ll look into how we may be able to better inform customers as to how to locate documentation.
A few others have written in about navigation challenges, here’s an excerpt that you may find helpful:
Although navigation can still be a challenge, we are pleased about some recent innovations on Cisco.com for finding information and getting back to it once you have found what you are looking for:
OnCisco.com, note the My Cisco tab at the top of the site - here's where you can add your bookmarks (including to PDFs), track or access Recent Service Requests, Software Alerts, Recently Used Products, Added Devices, Support Notifications, and the new Collaboration Spaces.
To get started quickly with the new customization features, we like this interactive little demo - point and click on the features you're interested in.
I can also understand why a documentation-specific tutorial could be helpful, but the information above may be of help. Thank you for posting the short guide and for spending as much time as you have navigating and searching for the right documentation!
We understand that this is less than ideal and encourage you to submit feedback (we will send the feedback on as well) using the feedback link at the very bottom of Cisco.com pages, the feedback form available within the chapters of a book, or using the yellow side-bar feedback form when available.
Introduction to Essential Utility for Optical Network ProfessionalsSnapshot of utilityFeature SupportedComposite Power calculatorNet Composite power Change when some channels are added/removedDirect Conversion for multiple parametersUse CasesSupported Tec...
There are few interoperability issues between 2960x and other vendors. In this article we will go over the steps on how to debug these issues.
Check the phy id from “show controllers ethernet-controller phy” output.
<snip from show controllers ethe...
It appears that you are trying to access end of life information from Cisco search. We have detected a problem with your script ("eol...) and would like to help. Please contact email@example.com if you would like support.