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. > > 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. > > I had trouble figuring out what a key is, > > see above. You don't have to know to set up your system. See above. Adding incomprehensible gibberish makes the documentation very difficult to follow. Especially given the fact that the documentation *does* try to explain what these things are, hence conveying the message that this is important to know. Just as importantly, the documentation is just plain unclear. I had a lot of trouble finding "instructions for Unix". All I found was instructions for Cygwin and Putty. The documentation is also overwhelming, considering how little actually information it actually has. 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? > I'm almost confident that you're not talking about the same document. We are. It is poorly written, daunting and hard to follow. You can only understanding if you already have a lot of previous knowledte. But that's stupid because the document is supposed to be read by people with no previous kowledge other that knowing how to use a computer. -- Daniel Carrera | I don't want it perfect, Join OOoAuthors today! | I want it Tuesday. http://oooauthors.org | --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
