What do you think about using video (or audio only) for documentation topics? Would it be useful? Are there places in the docs where you would like to see it? Hardware, software, other? What level of quality do you expect? Join the discussion.
I think video for hardware would be a very useful addition to the documentation in terms of cards/modules/connectors, how to insert them into the chassis etc. I know there are documents that show this in diagrams but sometimes it is much easier to appreciate when you see it visually.
Also a good example would be to show how to set up a console connection to a router/switch. Very helpful for troubleshooting for both TAC and NetPro etc. ie. you can just direct someone to the video and then tell them to get back after they have set it up.
The level of quality would have to be detailed enough so you could replicate what is being shown you.
We appreciate your adding to this discussion topic. Using video to document hardware installation and setup is an interesting exploratory subject for us. Thank you for your console connection example here. We wanted to ask - how would you use video: as a replacement to the written documentation or as a companion to them?
I see them as a companion rather than a replacement and different people prefer different approaches.
Personally i am happy to read a doc but i have worked with quite a few people who learn a lot quicker if they are shown how to do something rather than just being given a manual to read.
I wouldn't want to see any documentation to disappear, rather for video to supplement it. And i'm not sure how far video could help with configuration of devices altho i'd be interested to hear any ideas :-). As I said before i think hardware installation, cabling etc. are the areas where video could make a huge difference.
Very interesting subject here for sure! I agree with my friend Jon (+5 points Jon :) that Video should be used as a companion or value-add to the existing documentation. I have seen some good videos here @ CCO that could really be expanded to enhance the user experience here.
One idea that I think would work is a Video introduction for things like CUCM Licensing, product release notes, Upgrade Paths etc. etc. The other tools that I have seen that really "ROCK" are the user Tutorials for things like Unity VM and IP Phone useage. I think many people (like Jon nicely noted) are very visual by nature and these type of changes can add a great deal to the "learning" of both Admins and "Users" alike!
Keep up the great work! Happy Holidays!
You are spot on ( a +5 from NYC) about how Video could be of assistance for procedures like licensing and IP Phone usage.
It's safe to say that nobody wants video to replace written documentation. As you point out it should be created and refined for people who are visual by nature, and for those looking to learn something they might have missed in the written notes.
I also gave Jon (+5) for the suggestion that Video be used by support personnel wanting a console connection set up to a router and for inserting a card into a chassis.
Perhaps a demonstration video of someone who was trying to incorrectly take a card out of a chassis, the Wireless Controller blade in a 6500 comes to mind, could also be produced and the subsequent malfunctioning of the card could then be visually documented.
This is a great topic and I'm so glad Cisco has added this forum. I've been spending quite a bit of time lately writing documentation for clients, and can see the day when they will be asking me to produce Video to supplement my notes.