Wiki namespacing

[Angus Gratton]

It seems there's already a bit of confusion over the different parts
of the wiki, can I suggest we start namespacing pages?

For instance I just added a "Memory Map" page under Platform:Memory Map.

Other likely namespaces - HW,ROM,SDK,RTOS.

If folks agree this is a good idea then I can also do some renaming of
existing pages to move them into namespaces.


Angus

[Paul Sokolovsky]

Hello,

Well, I don't have that much advanced experience with mediawiki to
judge on that, and I don't see how "Platform:Memory Map" is better than
"Memory Map" (but I already fixed a broken link to the latter).

But where I see this namespacing thing to be useful is that "0.9.9 RTOS
SDK" matter. Ideally, it would be a namespace prefix, instead of page
name suffix. Methinks, at least.

But all in all, I'm +/-0 on that, if you think that's how it should be
done, please go for it. (But I'm not sure what permissions there're to
rename/move pages.)

>
>
> Angus
>
> --
> You received this message because you are subscribed to the Google
> Groups "esp8266-re" group. To unsubscribe from this group and stop
> receiving emails from it, send an email to
> esp8266-re+...@googlegroups.com. To post to this group, send
> email to esp82...@googlegroups.com. To view this discussion on the
> web visit
> https://groups.google.com/d/msgid/esp8266-re/20150716044518.GC10176%40ex2.lan.
> For more options, visit https://groups.google.com/d/optout.



--
Best regards,
Paul mailto:pmi...@gmail.com

[Angus Gratton]

Oops, I've obviously been using too many wikis lately. Namespaces in
Mediawiki don't work like I remembered them! They're not the feature I
was thinking of.

I moved "Platform:Memory Map" back to just "Memory Map".

A MediaWiki feature that could be useful is Categories, ie
https://www.mediawiki.org/wiki/Help:Categories

(allows creating automatic index pages, etc.)

... but I don't think it's a major issue, the way things are laid out
now seems good to me.


Angus

[Paul Sokolovsky]

Hello,

On Thu, 16 Jul 2015 22:21:29 +1000
Angus Gratton <g...@projectgus.com> wrote:

> Oops, I've obviously been using too many wikis lately. Namespaces in
> Mediawiki don't work like I remembered them! They're not the feature I
> was thinking of.
>
> I moved "Platform:Memory Map" back to just "Memory Map".
>
> A MediaWiki feature that could be useful is Categories, ie
> https://www.mediawiki.org/wiki/Help:Categories
>
> (allows creating automatic index pages, etc.)

Yes, I agree, as soon as there're enough pages to be in one category,
we should start adding category tags ;-).

>
> ... but I don't think it's a major issue, the way things are laid out
> now seems good to me.
>
>
> Angus

[Alex Stewart]

Yeah, I went back and forth with a few different possibilities of how to do all this stuff (namespaces, subpages, parenthetical suffixes, etc), and they've all got plusses and minuses..

One thing I wanted to point out, BTW:  If you have a page which has a parenthetical suffix (such as a SDK version), you can use the Mediawiki "pipe trick" to make linking to other pages in the same area easier:

For anyone who's not familiar, in Mediawiki, you can make links of the form [[foo|bar]], which will link to page "foo", but the link text will say "bar".  If, however, you completely leave out "foo", but leave the pipe character ([[|bar]]), Mediawiki will automatically construct it for you by taking a page name of "bar" and:

1. Tacking on any parenthetical phrase at the end of the current page's title
2. Tacking on any namespace prefix that the current page has

So, for example, if the current page is "my_func (IoT RTOS SDK 0.9.9)" and you put in a link to "[[|other_func]]", Mediawiki will automatically fill that out to be a link to "[[other_func (IoT RTOS SDK 0.9.9)|other_func]]" when you save the page.  (this is part of why I chose the parenthetical method for identifying the SDK in the page name, because it makes linking easier using this trick)

 (I really need to make a page of editing tips and tricks for this sort of thing..  Sigh.. tack it onto the ever-growing todo list, I guess..)

In general, however, I think it's generally best to just name pages with plain, descriptive names (i.e. "Memory Map"), and then let the organization be taken care of just by what other pages link to them.  That's the way most other wikis handle it and it seems to work pretty well (and it makes it a lot easier to reorganize things later if we want to).  I think we probably only need special designations when it's likely that there might be multiple versions of the same (or similar) pages which need separation/clarification..

Though I'm all in favor of using the categories feature, too, particularly once things get more fleshed out..

--Alex

--
You received this message because you are subscribed to the Google Groups "esp8266-re" group.
To unsubscribe from this group and stop receiving emails from it, send an email to esp8266-re+...@googlegroups.com.
To post to this group, send email to esp82...@googlegroups.com.

To view this discussion on the web visit https://groups.google.com/d/msgid/esp8266-re/20150716153759.47754168%40x230.