Mailinglist Archive: opensuse-wiki (40 mails)

< Previous Next >
Re: [opensuse-wiki] Are there any naming conventions?
  • From: "Rajko M." <rmatov101@xxxxxxxxxxx>
  • Date: Tue, 19 Aug 2008 19:06:59 -0500
  • Message-id: <200808191906.59375.rmatov101@xxxxxxxxxxx>
On Tuesday 19 August 2008 01:50:40 pm Marko Jung wrote:
The Style Guide [1] says nothing on page names.
Wikipedia has many rules for naming pages [2] and when to use subpages
[3]. I would like to cite a short excerpt from that article:

"Subpages were originally used on Wikipedia to differentiate between
subjects to create topical hierarchies of articles, but this proved
unworkable because articles tend to belong in more than one hierarchy.
The present system of disambiguation was adopted instead, and the
Wikipedia:Do not use subpages policy had to be rigorously enforced, as
well as retroactively applied. As of mid-2004, the category system
supports hierarchical organization while still allowing an article to
belong to multiple categories."

I would also propose this for the openSUSE wiki.

I started discussion once before, and the best we came with was that one level
of subpages will not hurt for special case where topic is discussed at
certain level, and prerequisites, or details are explained on subpages. Good
example would be "Style guide", with subpage about title naming. It is easy
to jump in article and than back using back link.

There is long time formed habit of using subpages. They look nice hierarchical
like directories in a file system, but in reality it is just bunch of
independent articles, with additional hurdle, to watch not to spoil back
links when you move article to better suited title.

Just put this in a "Style guide". It sounds as a good reason not to use them.

Besides, it gives a different way to use categories. Not as absolute, starting
from few general categories, but relative, independent as focal point for
articles that belong to the same group. This would remove need for templates
that list all articles in one group. All that would be needed is to put them
all in the same category. No need to change template when you want to add
article to the group.

Apropos remembering. If we use equally easy to remember schema with spaces
instead of slashes it will be easy to remember. For instance in version
related article, suffix will give articles sorted next to each other in
category that can have the same name as article.

--
Regards, Rajko
http://en.opensuse.org/Portal needs helpful hands.
---------------------------------------------------------------------
To unsubscribe, e-mail: opensuse-wiki+unsubscribe@xxxxxxxxxxxx
For additional commands, e-mail: opensuse-wiki+help@xxxxxxxxxxxx

< Previous Next >