FusionBB
Username Post: Do you use documentation?        (Topic#28723)
Mayoff 
Retrospect Backup Commando
Posts: 11522
Mayoff
12-09-08 09:21 AM - Post#114321    


I am wondering what type of documentation do you use.




What type of documentation do you use the most? (top 2)
Printed or .pdf user's guide
Software Help
Read Me
Website KB content
I never read documentation (especially on the Mac)
You may choose up to 2 options.
Votes accepted from 12-09-08 09:21 AM to 12-09-18 09:21 AM.
View results
Robin Mayoff
Senior Manager, Retrospect Tech Support
Retro-Talk, KB & Forum Admin

Follow Retrospect on Twitter









 
rhwalker 
Lifetime Achievement Award
Posts: 5382
Re: Do you use documentation?
12-09-08 10:07 AM - Post#114324    

    In response to Mayoff

Robin,

Your question is a bit in the abstract because it isn't focused on Retrospect. There are examples of how other software packages work that might be closer to the ideal for some of us.

Right now, the Retrospect "Software Help" (a/k/a/ Help menu) is somewhat like a condensed version of the user manual. A suggestion for improvement, which some products have, is a "?" icon on each admin page such that, when you click the "?", you get a targeted help page for that particular admin page, explaining the options for that page rather than a generalized user manual.

One model, though far from perfect, would be how the SonicWALL firewalls have their help system. There's an online demo at:
SonicWALL demo site

You (and the Retrospect X developers) might want to poke around a bit there to get some ideas (but don't adopt the bad things about that interface).

Russ







 
alternety 
Occasional forum poster
Posts: 23
01-21-09 07:13 PM - Post#115696    

    In response to rhwalker

I do, and would if I could just find a manual for Retrospect Pro 7.6.







 
Mayoff 
Retrospect Backup Commando
Posts: 11522
Mayoff
Do you use documentation?
01-22-09 12:26 AM - Post#115700    

    In response to alternety

http://kb.dantz.com has all documentation
Robin Mayoff
Senior Manager, Retrospect Tech Support
Retro-Talk, KB & Forum Admin

Follow Retrospect on Twitter



Edited by Mayoff on 01-22-09 12:26 AM. Reason for edit: No reason given.







 
rhwalker 
Lifetime Achievement Award
Posts: 5382
01-22-09 08:07 AM - Post#115743    

    In response to alternety

See the first entry in the drop down for "Support Resources" in the navigation bar near the top of this page.







 
colin415 
Newbie
Posts: 11
01-30-09 05:04 AM - Post#116141    

    In response to rhwalker

Just wanted to say this: the first option, printed/PDF documentation are two different universes for me! PDF I can search, printed I can not (and the poor trees!) (and you have to store it somewhere) so I practically put PDF into the "Software Help" section in my mind.







 
jaotto 
Newbie
Posts: 3
Re: Do you use documentation?
02-04-09 06:29 PM - Post#116400    

    In response to Mayoff

Very strange list of options.

My preference would actually be:

1) Website (structured document, not KB)
2) PDF

pdf and printed guides are completely different things. Read Me should be installation notes, not documentation. Knowledge base is useful for when things go wrong, not useful for documenting what should happen. Software help has potential, but is so often implemented in such a flimsy fashion as to be unusual.

Please html documentation (with an option to download the while document file tree).







 
Joel Anderson 
frequent Poster
Posts: 76
Joel Anderson
Re: Do you use documentation?
03-28-09 07:32 PM - Post#119243    

    In response to jaotto

I like when a form you are looking at in an application has a help button on it that takes you to information relevant to what you are looking at.

By the way the videos on v8 are awesome. Keep them coming. Better than any manual, except for advanced info.







 
Brendon Randall 
Occasional forum poster
Posts: 10
04-08-09 01:18 PM - Post#120020    

    In response to Mayoff

Another vote for resolving this. I am having the same issue: After a period of time (varies), server installations which have been previously functioning stop seeing any clients at all via multicast. Also, dependent scripts/viewing drive contents will consistently fail.

Adding the source via IP times out essentially... I've let this run for 2+ minutes per before losing patience.

This is on 2 separate installations of Retrospect 8.0.594.1, with mixed-environment clients, although predominantly Mac clients. Affects all scripts, proactive, timed, and manual executions. All software is up-to-date. One installation is 100% local and controlled for testing and exhibits these behaviors. Client software is responding in the client and ready to go, toggled on/off and restarted.

Furthermore, I am also experiencing the "I had to restart the physical server, which actually acted like a crashed/auto-recover server to get it running again" symptom on ALL 3 systems running the new Retro engine.

Lastly, I'll add that my attempts to stop the Retro engine through the prefpane do not respond as soon as this happens. In an attempt to kill the process through Terminal, I can generate consistantly a recurring error in Console log indicating that "(com.retrospect.RetroEngine[41]) Did not die after sending SIGKILL xxx seconds ago." This will recur up until restart (hard restart, natch) of the offending Retro server machine, up to 167165 seconds on longest spin through.

Advice? Info on the next patch?

Regards,

Brendon Randall







 
Mayoff 
Retrospect Backup Commando
Posts: 11522
Mayoff
04-08-09 03:46 PM - Post#120022    

    In response to Brendon Randall

Did you post in the right place? this topic is a poll about documentation.
Robin Mayoff
Senior Manager, Retrospect Tech Support
Retro-Talk, KB & Forum Admin

Follow Retrospect on Twitter









 
Brendon Randall 
Occasional forum poster
Posts: 10
Do you use documentation?
04-09-09 02:14 AM - Post#120037    

    In response to Mayoff

Hmmm, used the quick reply to another thread, not sure how this got over here?!! Actual post I was referring to (if you're looking, for it here, EU!): http://bit.ly/iNVJE

Edited by Brendon Randall on 04-09-09 02:17 AM. Reason for edit: No reason given.







 
arth1 
Newbie
Posts: 5
04-09-09 07:16 PM - Post#120119    

    In response to Brendon Randall

Missing option: man pages

Seriously, though, most of what sysadmins do are through a command line interface, and PDFs and popup-help isn't too useful then. Plaintext files ("Read Me") should not be skipped in favour of GUI based documentation -- why not provide both?








 
michelef 
Newbie
Posts: 47
05-04-09 07:03 AM - Post#121786    

    In response to Mayoff

I do have an Apple RAID, but it's not one of the volumes that are backed up. Also in case it helps my is on a pair of external E-SATA drives.







 
Mickelangelo 
Newbie
Posts: 2
Mickelangelo
Re: Do you use documentation?
08-13-09 07:05 PM - Post#126612    

    In response to Mayoff

My preference is website







 
JamesGraham 
Newbie
Posts: 1
01-12-10 01:23 AM - Post#133647    

    In response to Mickelangelo

I'm disappointed that there's no User Manual for Retrospect 8.0 for Mac. There are many aspects of this software that remain a mystery to me. I don't think it should be the users' responsibility to go hunting around forums and the knowledge base to get answers. Even a robust help system would be worthwhile. I'm wondering how committed EMC is to this product.









 
rhwalker 
Lifetime Achievement Award
Posts: 5382
Do you use documentation?
01-12-10 04:27 AM - Post#133663    

    In response to JamesGraham

  • JamesGraham Said:
I'm disappointed that there's no User Manual for Retrospect 8.0 for Mac. There are many aspects of this software that remain a mystery to me. I don't think it should be the users' responsibility to go hunting around forums and the knowledge base to get answers. Even a robust help system would be worthwhile.


From the Director of EMC Retrospect Product Management five months ago:
Where the @#%& is my Retrospect 8 User's Guide?

  • JamesGraham Said:
I'm wondering how committed EMC is to this product.


There is no tech writer on staff. Draw your own conclusions.

Russ







 
Richy_Boy 
Occasional Forum Poster
Posts: 365
02-28-10 11:46 PM - Post#135979    

    In response to rhwalker

I only seem to use documentation when something doesn't work as expected, for example, the WOL / system sleep functionality in 7.7.

Of course, I've usually stumbled on a bug or I'm left scratching around to try and find material to help out.

Rich
Retrospect 7.7 Multi Server + Value Pack
2x Xeon 2.8GHz CPU, 3GB RAM, Windows XP Pro, ReadyNAS Pro > Off-site over rSync

* Facebook group setup: "EMC Retrospect Users"








 
Icon Legend Permissions Topic Options
Print Topic


12166 Views

Forum and Retro-Talk

Google Search

 

Retrospect KB Search

FusionBB™ Version 3.0 FINAL | ©2003-2010 InteractivePHP, Inc.
Execution time: 0.626 seconds.   Total Queries: 76   Zlib Compression is on.
All times are (GMT-11). Current time is 08:45 PM
Top