Hi *, On Sun, Feb 20, 2005 at 08:58:30AM -0500, Daniel Carrera wrote: > Christian Lohmaier wrote: > > > > Referring to other documentation is a good sign that the procedure is > > > complicated. > > > > No. It is just a sign that there are many ways to achieve things. > > You just proved that you are not familiar with writing documentation. > Giving people a dozen pages to read to "give them choice" is incredibly > counter productive.
No. You proved that you don't have a clue. You cannot handle all the ways to setup a ssh tunnel in one single document. There are way to many programs out there. I'm happy to listen to any /advice/ - but you don't give advices, you only complaint "the documentation is bad". Jean however stated what her main problem was. See the difference? > > > But only at the expense of yet another barrier. > > > > What barrier? > > Requiring Win users to learn Cygwin is another barrier. A big one. Reality check: So the user has to learn "Putty" which - as you can see - is much harder because of the different option pages and boxes on where to enter things. Compared to that just launching cygwin and pasting the command into the window is a big barrier? You don't have to "learn cygwin". Only install it, run it, and paste the command. Again: Cygwin as well as PuTTY are two ways to set up the tunnel nothing more, nothing less. Sure you can continue and use cvs with cygwin as well, but this is not necessary. > > And a personal note as well: I don't think that anyone confident with > > linux/unix will have problems with these instructions. > > The only thing is that you must be willing to read the /whole/ thing. > > This is a very good example of what's wrong with your attitude. You are > blaming the user for not understanding the documentation. > > I am confident with Unix/Linux, I have been using it exclusively for > several years. Using a software on a OS doesn't make you confident with the OS itself or other programs. > I program in it, I write shell scripts every day, I already > even had experience with CVS, through my involvement in the Mono project. > And I had a very hard time plowing through this. > [...] > Your target audience is *not* "confident Unix users". > > Do you see that? Yes I see that. But you are too forced in seing in me the guy that defends the documentation that you don't see that this is not the truth. > You cannot assume that the user is confident with a Unix shell. You can't > assume that the user knows what the heck a Unix shell is. And as long as > you don't see that, the documentation will remain un-useful. No matter how you call it, but what is non-useful are comments like "The documentation is unuseful", "the documentation is too complicated", etc. ciao Chistian -- NP: Limp Bizkit - The Only One --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
