From mboxrd@z Thu Jan 1 00:00:00 1970 Message-ID: <50CE3945.90503@gmail.com> Date: Sun, 16 Dec 2012 22:12:37 +0100 From: hauptmech MIME-Version: 1.0 References: <50CE1EE9.3060607@gmail.com> <50CE2CDE.3040904@xenomai.org> In-Reply-To: <50CE2CDE.3040904@xenomai.org> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Subject: Re: [Xenomai] Documentation and WIKI List-Id: Discussions about the Xenomai project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Gilles Chanteperdrix Cc: xenomai@xenomai.org 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'?