Jean Hollis Weber wrote:
> >2nd: Each of those should be divided into 2 subsections:
> > - Getting Setup.
> > - Editing the website.
>
> Is there any difference between platforms in editing the website? If not,
> then one set of instructions should suffice for that part.
The most difficult part of editing the website is learning how to use CVS,
and *that* is very different between different platforms. It is different
because on each platform you'd be using a different program. On Unix and
Linux you'd generally use the command-line 'cvs' command. But Windows
doesn't come with that. So you'd have to use some GUI or another.
> I think your approach on the getting setup instructions is very good. Just
> one question: are there any platform-specific difference in the bits on
> "Submit your public key" and "Write to the list with the following
> information" (items 3 and 4 in your instructions)? If not, then one set of
> instructions for those topics should suffice.
Part 14 of step (3) is platfrom-specific.
I figured that duplication was fine, on the basis that electrons are
cheap. And I felt that each given user would be more confortable with a
single set of documentation instead of having him jumping around.
> If my assumptions on common vs platform-specific information are correct,
> how about this as an alternative outline:
>
> GETTING SETUP
> Intro
> 1) Generate an SSH key (include step on locating the public key)
> - Instructions for Unix and Linux.
> - Instructions for Windows.
> - Instructions for Mac.
With your ammendment ("locating the public key") I am happy with your new
outline.
Cheers,
--
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]
