On 5/28/06, Jerry Westrick  wrote:
> Hello there, my first post post here...
> I was sent to this list from the OpenSUSE list...
>
> I'm trying to write some documentation about
> remote access to SUSE.
>
> Unfortunately, I'm down with a real bad flu...
Yes, but this sounds like a reason TO work on the wiki,
otherwise you should go out an enjoy the real world  :-)

> my problems are:
> 1) the documents look like shit.
> 2) I need to use tables to organize the options.

Wiki tables are a litte tricky, but simple tables are relatively simple.
You can also use HTML tables, which means if you have a way to convert
your original text to HTML, it makes it easier.


> 3) I'll want lots and lots of screen shots for the newbies...

Simple but does require a bit of work. You need to upload each image
that you want to use. And then insert them using a tag like
[[Image:filename.png]] where filename.png is your image filename.
See this (on-topic) page for an example:
http://en.opensuse.org/Terminal_Services_Client

> Additionally, I find it hard working on the wiki documantation.
You will soon have forgotten the luxury of WYSIWYG :-)
and practice makes perfect.

> Any tips appreceated.
1. Have a look at www.Wikipedia.org you can look at the source of any
page to learn how they created particular document features.
2. Specifically read this page:
http://en.wikipedia.org/wiki/Wikipedia:How_to_edit_a_page it is the
best single page on how to edit in a wiki.
3. When moving from a document to a wiki, remember that you are now
part of something larger. And also try to break up large pages into
logical pages. eg: SSH Tunnels should be explained on it's own page so
that a wide variety of pages (including from other authors) can refer
to it (ie on a page on how to use SSH from Windows it should not
explain what SSH tunnels are, but just link to the SSH Tunnel page).


> Jerry
> P.S.  How do I get something like this into wiki?
> http://home.intergga.ch/Westrick/Using_SSH_tunnels_from_M$_Windows.pdf

I did one page from the pdf :
http://en.opensuse.org/SSH_Tunnels_from_Microsoft_Windows

Peter 'Pflodo' Flodin