Re: [Xenomai] Documentation and WIKI

[hauptmech <hauptmech@gmail.com>]

On 12/16/2012 09:19 PM, Gilles Chanteperdrix wrote:
> On 12/16/2012 08:20 PM, hauptmech wrote:
>
>> I'd like to propose a buffer page between the menu options and non-wiki
>> pages. Specifically GIT repositories and Installing. A couple reasons...
>> One it's unexpected, as conventionally links to outside pages are marked
>> as such in a wiki. Two: a wiki page between the menu and the external
>> page allows us to put some summary info to help ease the reader into the
>> bigger document and add useful tidbits (like the existance of denx)
>>
>> Examples of buffer pages are at:
>> http://www.xenomai.org/index.php/Install_Xenomai
>> http://www.xenomai.org/index.php/GIT_repositories
>>
>> Link them in (I don't have permission) if you agree.
>>> The "getting started" page is unfinished (contains empty paragraphs),
>>> and outdated (contains dead links and references to things like the
>>> simulator which is currently not really usable) at the same time. I do
>>> not believe we have the resources to maintain such a page up-to-date.
>> I think the getting started page is a nice little introduction. I've had
>> a pass at cleaning it up.
>>    http://www.xenomai.org/index.php/Getting_Started
>> There's more that could be done but if it looks ok, consider linking to
>> it from the menu 'Start here'
>
> It is sort of a replacement of "Start here", so, from my point of view,
> it should be the "Start here" page, and also contain what the "Start
> here" page contains (namely, the link to the "porting posix applications
> to xenomai", and all the links to all the API documentation versions).
>
I see what you mean. The Documentation Summary (start here) is nicely 
compact, I wouldn't want to ruin it. What about calling 'getting 
started'  'beginners guide' and inserting a link to it between 'Start 
here' and 'Installing'?