Diary: Technologies: AROS: Documentation Documentation Documentation brings Developers Developers Developers!!!

Hoping Ballmer did not patented its citation 😛

Well, cause of my job duties this is not at all a new topic, but think is good to bounce it here. The Amiga Os 4.1 on Sam good new is a week old and probably, when it will be possible, will treat it here too but for now let’s do business as usual.

One of the latest topic comments in my last article in the italian forum (translated here btw) was from Tadsince1995 and brought me to forward it and enrich it in Aros-exec:

(translated from italian:)
So, after Robert Norris, even Michaelis going. The biggest problem is not only that they will not workanymore in AROS, but will be a huge disgrace the fact that so far thoseare the most prepared developers, therefore their own knowledgeluggage, shared by very few little people, will be lost.
I(tadsince1995) always supported a “Documentation bounty” because thereis a GRAVE lack of documentation for the low level part of AROS.Nothing about the USB stack, almost nothing on how to write drivers,etc. How an operating system can proceed if newcomming coder have noideas in how and where to begin with?
Especially the fact that,obviously, people have other committments and there might be no time todo reverse engineering on the code, while having some good tutorialmight save them lot of time.

And here is my enrichment:

I support fully the point of view of Tad: this is my personal requestfor Michael, for Robert, if he is still around, and for all low leveldevelopers: do not only leave the source available: do not assumepeople to have same skills as you: PLEASE DOCUMENT LOW LEVEL AROS, forthe sake of future development following your contribution:

Amiga/AROSscene is too little to expect people to find enough documentation(outdated at most), and Amiga/AROS internals are too different fromothers to expect the inner workings to be understood easily.

Therefore the usual Open Source method to read sources in this case cannot apply fully.

[there was a withdrawn part to avoid discussions]

To the people still at work:

you know this project needs developers and, IMHO, if not a schedule -by philosophy-, at least it needs a post-it in the border of the screen where to step the fundamentals, in short: “a plan”.

Forget one moment about ports: i think the system needs to be finished and polished. I have ShinkurO and others complaining sbout buggy MUI classes, myself in the verge to do a review of AROS for a magazine being a bit frustrated from the lack of visual feedback from the system as cursors or messages; LUA working but zulu not fuilly implemented in case somebody needs to write new applications, not only games (thanks mazze for your efforts in trying to build SDLbasic).

[end withdrawn part]

Ifeel emotionally involved with this project and , as Paolone, i thinkit has more potential than even eople here can expect. So, let’s try towork in a synergistyic (collaborative) way and pave the street fornewcomers as much as possible.

That is, my personal message at the community; i really wish AROS not to sink, i already said in past and will continue to say it in the future.

My personal contributions are actually in helping ShinkurO together with Tadsince1995 in translating its Programming guide for Amiga Oses and in writing a review of AROS for a magazine, even if both activities are going on slowly in the free time due to the aforementioned job duties.