House Style

From RepRap
Revision as of 18:13, 22 January 2010 by Sebastien Bailard (talk | contribs) (New page: I've been thinking about how we're going to organize the (post)mediawiki. Because 1) I seem to have elected myself "Seniormost Library Gnome" and 2) because I have no idea how we're going...)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
I've been thinking about how we're going to organize the (post)mediawiki. Because 1) I seem to have elected myself "Seniormost Library Gnome" and 2) because I have no idea how we're going to do it yet.

And it's a bit tricky. So I'm awake at 5:28 AM. Which means I'll ask you guys to sort it out. So I can go to sleep, knowing that in the morning, this riddle will be solved, and I can file this thread a week or two from now inside "Library Administration and Announcements" [dev.forums.reprap.org]

First idea: a suggested-if-you-feel-like-it RepRap house style, for self-labeled parts.

Say we have [objects.reprap.org]

Maybe it gets a 2D barcode, using whatever's most popular and works: [en.wikipedia.org]

But, speaking as a human. I think human-readable is important, speaking as a human. But it also gets the URL of the part. Because then the part contains its documentation.

So: www.reprap.org/wiki/Mendel/Widget but that's too long, so reprap.org/wiki/Mendel/Widget ... everyone knows it's RepRap.org, and we don't need "wiki", so Mendel/Wiget but that doesn't look stylish enough, so maybe Mendel/Widget To indicate wiki-ness. One of the last two. It's an idea. Thoughts? Like it? Hate it?

One reason it will be handy is that a lot of folk just google stuff. So they look at something, type in Mendel/Widget, and it will work.

But also because the part is bonded to its documentation a bit more neatly. And people who edit the wiki will get it instantly. Mendel/Widget = Mendel/Widget

Unless we want to file everything using a n-digit 36 character code, but it' utterly impossible to enforce that even though it scales better. 5ceae3ce3klnwerynjry3mbq .... Bleeeergh. Nope.

So, is this good enough for the suggested-if-you-feel-like-it RepRap house style until we figure out something cleaner and more elegant?

I'll start a new thread for the hard question. This was the easy one.