1st: Thank you for your enthusiastic response.

I think I should start with "a gentle introduction to Antville" Ofcourse I can guess what should be in there but if you would please make me a small list of the things you guys think should definitely be included in the "a gentle introduction to Antville".

GreetZ Peter Lunk

the gentle intro would be a good place to start.

Here's my first fast list of things that should be in, making it up as I write, so not necessarily in the right order:

• Overview of Antville features (but not an in-depth explanation of what Weblogs are)
• Registering, logging in, creating a weblog
• Explanation of the most important preferences settings (setting weblog online, setting who may post stories etc.)
• Basic Layout options in preferences, e.g. colors, font sizes etc.
• Short description of how to post a story
• Short description of how to upload an image and use it inside a story

Well I'm stopping here, as I said the list is not well thought out, but maybe a good starting point.

for the offer! as hns wrote, we're not that many people working on antville, so any help regarding documentation or contributions to the application code is warmly welcome. regarding the "gentle introduction" i think there are several things that should be explained (mainly because they can be confusing):

• the basic structure of antville (how stories are organized (timebased/topic-based), images, goodies, polls, memberships and registration ...)
• weblog-preferences
• templating: the concept of skins and the skin-structure of antville (just a broad overview)
• what are macros and what they can/cannot do (i'd just explain the basic ones like link, image etc.)
• the different user-levels and their rights (admins, content manager, contributor, subscriber)

of course these are just rough ideas, but maybe they're helpful for starting this project. (oops, i just saw that hns was quicker :-)

Yes, skinning and macros should be mentioned in there, but I thought that for the sake of gentleness, we shouldn't put too much emphasis on technical terms and instead help people getting started, even if they don't know that what they're copy-pasting is called a macro. (There must be something left for "The ultimate guide to Antville skinning", after all ;-)

BTW, how about setting up a dedicated weblog for discussing and writing documentation stuff? Or would that be too early?

i just meant that (for the curious ones) it might be helpful to at least know that everything enclosed by <% and %> ist a macro - not much more. might help to understand how to include images in stories or the like. the rest should definetly be explained in the "ultimate guide".

i think it's too early to create a topic for discussions reg. documentation, but let mrlunk/seewolf decide if they need one.

the more, the merrier. (At least until we've reached the magic number of 18273).

you're welcome! (hns: what's the meaning of this magic number?)

but believe me, it is magic ;-)

the real magic number is 42, but this might be wrong ;-)

three is the magic number!

you beat me on this one, but i had this children song in mind. nice interview with bob dorough, btw.

Try this in C !

 ultimate_answer_t deep_thought(void)
    {
        sleep(years2secs(7500000));
        return 42;
    } 

THHGTTG ! D Adams !

More indepth analasys on the number 42 ãs generated by the superduper computer DEEP THOUGHT www.empirenet.com

Log into your page with login and password then goto imagepool and click view on the message you want to view, the comments are beneath the original message