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
next 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.