Hi Daniel, *, On Sat, Feb 19, 2005 at 07:27:40PM -0500, Daniel Carrera wrote: > Christian Lohmaier wrote: > > > > 2) Documentation is not a replacement for simplicity. > > > > But how can the documentation be any simpler than it is now, explaining > > and mentioning each single step? > > You don't understand, documentation is no replacement for having a simple > process. It is better to have a simple process, than to have a complicated > process with documentation.
No objections. But when you cannot change the system you have to live with it. > > > I had trouble figuring out what the heck a tunnel is, > > > > Do you really have to know what a tunnel is? > > 1) The documentation made me feel like I did. > 2) Documentation that refers to things the user doesn't understand is not > simple or friendly. > > If I explain a process and I start referring to things you don't > understand, you will have a much harder time following. Worse yet, the > documentation is written in a way that presumes knowledge of these > concepts. OK. That is something concrete to work with. What is your suggestion on how to explain a "tunnel"? > [...] > The documentation is also overwhelming, considering how little actually > information it actually has. So what are your suggestions. (Plese be concrete, not just say "rewrite it, make is more user-friendly") > The documentation is very poorly organized, and key steps were missing or > very ambiguous. > > > Are you talking about the same document? > > Yes. I checked. > > > what is ambiguous with the instruction 'enter "ssh-keygen -d"' > > For one, the fact that it's under Cygwin and I don't have Cygwin. Why > should I look there? OK, good point. Although the doc states "Cygwin, from Cygnus Solutions, provides a nearly full Unix environment on your desktop" This may be overlooked. ciao Christian -- NP: Donots - We're Not Gonna Take It --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
