All of lore.kernel.org
 help / color / mirror / Atom feed
From: hauptmech <hauptmech@gmail.com>
To: xenomai@xenomai.org
Subject: [Xenomai] Documentation and WIKI
Date: Sun, 16 Dec 2012 20:20:09 +0100	[thread overview]
Message-ID: <50CE1EE9.3060607@gmail.com> (raw)


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








             reply	other threads:[~2012-12-16 19:20 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2012-12-16 19:20 hauptmech [this message]
2012-12-16 20:19 ` [Xenomai] Documentation and WIKI Gilles Chanteperdrix
2012-12-16 21:12   ` hauptmech
2012-12-16 21:30     ` Gilles Chanteperdrix
2012-12-16 22:48       ` hauptmech

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=50CE1EE9.3060607@gmail.com \
    --to=hauptmech@gmail.com \
    --cc=xenomai@xenomai.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.