hello everybody,
as i said, here's the quick-start guide. It's not much but i hope it can help people take their first steps...
I have to thanks rokytnji for his excellent flash-updating how-to however, i kinda took that and modified it into the one found in this guide.
I'm uploading it as an abiword .abw file and as a .txt file.

Looking good the Convert,

I have a few suggestions to make. To me a quick run through of the control center, window manager (where to find / access configs, antiX utilities to change options, etc... ) and running / accessing basic programs ( both terminal and GUI ) would be beneficial. Maybe as a"getting familiar with antiX" section.

If you find time good explanations of operating the"antiX apps" would be great! This I think is bigger and more difficult to produce, but I believe it is essential as you cannot find a toutorial on these apps by"googling".

As a note to what you have so far, I believe if you would like to upgrade the flash player you can do so by running the command"update-flashplugin-nonfree" as root in terminal. I am not 100% sure, but this is the way I have found by googling and it seems to work. (At least I have not got any request for updates __{{emoticon}}__ )

glad to hear it's looking good dave!
thanks for the suggestions, they are always welcome! I'll try to get them all in the guide and post the new version.
thanks for the flash tip too, i didn't know this. i'll put that in it too.

Good job the convert!

My contribution:

1. Added a link to antiX FAQ

2. Converted your txt into a asciidoc format
asciidoc uses a simple wiki-like markup language; I edited the original text in geany (unfortunately, geany -- scintilla in fact -- has no syntax highlighting for asciidoc; emacs has, but I did not try it)

You can convert the asciidoc text to html: This generates the quick-startguide.html file

For generating a pdf: Getting asciidoc: If you don't add the --no-install-recommends option, you will get a huge download !!
I don't know if the pdf converter a2x -pdf is available in the minimal install

Find attached the txt file - I should have renamed it - , the html output, and the pdf

You can embed images in the html file, using references (the images can be strored in a images directory relative to the html file directory)

If you are interested, I'll give you some links and examples

Thanks again

thanks,i've been able to look at the txt file and it looks good and that extra link is a good add-on but...
... the pdf is encrypted? and the html won't show. weird, probably got something to do with me though...
and yes i'm interested in some examples, always happy to learn more!
still working on dave's ideas, they require a bit more time and i'm kinda busy lately, but i'll post it as soon as possible!

the convert:

that is black magic, don't know why the pdf dowloaded looks encrypted !!! however I can open the html file

I am not able to upload .txt or .pdf files: extension not allowed (nor tar or tgz...)

I test another upload...

==============================
Seems to work now, please try it...

That latest pdf is ok.

Thanks to the convert for starting the guide and lagopus for the conversion to pdf/html.
I really like asciidoc and think we should use it for all our documentation.
For those that do not know how to use it, but want to contribute text to the guide, do so and I'm sure it can be converted to asciidoc style fairly easily.

About antiX documentation and asciidoc:

I looked at asciidoc 2 months ago when I had the ambition to translate the FAQ to french.
The FAQ is a html document. You can edit the source in a html editor, but it is not very handy, and the layout of the output may be different from the original document.
Editing the html source does not obey the principle of"separation of presentation and content" (TM)

Using CSS style sheets we can have a uniform style for all the documentation

Converting a html or pdf document to asciidoc is quite simple:

• select and copy the text of the original document
  paste into abiword as unformatted text
  save the text document
  open it in geany and add markup

hey everybody,
it's a lot later than i planned it to be and it's still just a quick'n dirty version. (school's consuming all my time right now and it's probably gonna keep doing so...)
i'm planning to clean it up and make it more complete but i'm already uploading this one to let you guys know i haven't forgotten it! __{{emoticon}}__
P.s. I'd like to know if this are the antix-apps dave meant cuz i'm not really sure...

Yep all the apps like that,
others would be antix 2 usb, and icewmcc. All the apps that I know of have a gui link to them (not sure on the locations), but if you would like a list to look at you can go to /usr/local/bin.

In the future, as I package these apps, they will all have a desktop shortcut in /usr/share/application/antix these will therefore be in the menu also. Also there will be some slight changes to apps ( EG: add-start add-key ) and larger changes (EG: the wallpaper app). The wallpaper app is being changed completely, but apps like add-start, add-key will read and output a particular session. So there will be no more need to choose your own session (of course you can invoke the script to a particular session EG: add-start -ig ig = icewm graphical) I am also making a terminal side to these apps, in the event that you may bork your desktop, but more for other scripts to be able to utilize them.

This is in the future, as there are several apps that need packaging and currently I have about 4-5. It is just as a heads up for your guide.
Dave