I must admit a lot of the customers I work with in support do not utilize the full potential of Macromedia LiveDocs. Once they realize you can view comments that have been submitted by other developers that hit the same road block they did…they never go back to using the documentation in the app itself unless it’s for general knowledge.
The LiveDocs are super powerful in my opinion by allowing tech writers the ability to make changes on the fly if necessary and allowing anyone to submit a helpful tip or workaround to an issue that cannot be resolved easily.
The Dreamweaver and Flash community eats the LiveDocs up like its icing on a cake and now Fireworks 8 will have the ability to use LiveDocs which is fantastic and something I’ve been waiting to have for quite some time.
Although, Im not seeing the Contribute/Flashpaper community as active as I thought it would be and hopefully that will change since Contribute issues can get pretty hairy and complex depending on the customer’s environment. I’m expecting to see this change with Contribute included in Studio 8 now. Woohoo!
Also, for us commandos in support, this is a useful way to get a workaround or update out ASAP without dealing with all the normal channels we have to go through to get something published. Ya!
Benefits you have with LiveDocs:
- Fresh and updated Documentation
- Add comments to help others that might hit the same scenario
- Read comments so you don’t spend hours figuring something out that someone else already did for you.
LiveDocs have been around for quite some time now and have helped me out a ton.
Here’s an example of how it helps others:
Using the ProgressBar component
Do you find the LiveDocs helpful? What would you change about them to make them even easier to use? Not that anything would change, but Im just curious if anyone has a better way of doing it. I love LiveDocs! Would I marry them?? Maybe.