From mboxrd@z Thu Jan 1 00:00:00 1970 Message-ID: <50CE2CDE.3040904@xenomai.org> Date: Sun, 16 Dec 2012 21:19:42 +0100 From: Gilles Chanteperdrix MIME-Version: 1.0 References: <50CE1EE9.3060607@gmail.com> In-Reply-To: <50CE1EE9.3060607@gmail.com> Content-Type: text/plain; charset=UTF-8 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: hauptmech Cc: xenomai@xenomai.org 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). -- Gilles.