From mboxrd@z Thu Jan 1 00:00:00 1970 Message-ID: <50CE1EE9.3060607@gmail.com> Date: Sun, 16 Dec 2012 20:20:09 +0100 From: hauptmech MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Subject: [Xenomai] Documentation and WIKI List-Id: Discussions about the Xenomai project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: xenomai@xenomai.org 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' > I agree with you, we have some information on the wiki, but it seems > hard to find, seeing how people are asking again and again the same > questions about configuring an x86 kernel, which are answered and > hyperlinked in at least three pages on the web site. It must mean that people are not seeing it as they navigate. It is a bit spread out. And to be honest, 'troubleshooting' is not where I'd go looking for configuration info. On the other hand, some people just need lots and lots of repetition before it sinks into the skull. -hauptmech