[LEDE-DEV] [wiki]Wiki structure proposals and some questions

[Alberto Bursi]

On 09/29/2016 01:49 PM, Martin Tippmann wrote:
> Not sure if that's a good idea and better than a list because it's
> effort to maintain, would be cool if these pages could be a "fallout"
> of a category in the table of hardware and be generated and updated
> from a single source.

The main point is that it improves awareness, while using the wiki to 
get at their device page, people will see that LEDE supports A, B and C 
category of devices.

It also helps convey that LEDE isn't just for routers, and in a 
(hopeful) future you might have people that don't come on the wiki for a 
router (or even not for a nas), so splitting the bigger categories is 
good imho.

While there will also be a "search the ToH" page for those that want to 
search stuff.

Adding the category to the ToH would also be a good idea as people 
coming to look for a NAS (or anything that isn't a router) currently 
don't have much choice than reading through a table filtered by giga eth 
and whatever.

And as you said all this is easy to auto-generate/update if you add 
device category field in the ToH.
>> The general idea is making something like NasCentral wiki (they do it with brands and make sub-wikis with a different hostname, I'm not asking to make subwikis here) http://www.nas-central.org/wiki/Main_Page
> I personally don't think that this approach would work well for LEDE -
> the default setup is the same for all models and hardware details are
> mostly abstracted away and not model specific. Maybe it's useful to
> group documentation for NAS like hardware into the same namespace or
> something like that but the overall idea is IMHO that you can do what
> you want with the router, or maybe I'm did not fully understand you
> here.

I was talking of layout/esthetics.
I wanted to make a general "LEDE supported hardware" page with images of 
all categories of devices (a generic router, a NAS, a wifi audio box 
thingy, a devboard and so on), and when people click on that they land 
in a page with a list of all the devices in that category.

No brands as we don't deal with brands, just dividing by device type.
I used NAScentral wiki as an example of layout, as you see their main 
page is like that (but with brand symbols).

We could have the LEDE logo in the middle and all images of supported 
device categories around it, like them.

> But there are already a lot of wonderful and great router icons here:
> https://github.com/Moorviper/Freifunk-Router-Anleitungen/wiki  maybe
> these could be used and build upon.

wow. :) They are sure nice, but I'd say "having a proper standardized 
image for all supported hardware" is not crucial for now.

>
> I'm a little late (sorry) but I hope we soon have a staging wiki were
> we can experiment and setup different ideas without breaking stuff.

Well, good for the future.

But currently the wiki is little more than an empty stub, I can always 
try to put down a skeleton of what I'm proposing and if you don't like 
it I'll roll back to current stub state.

>>> Now, apart from that I'd like to note that while I can get a nice
>>> forum-like interface where I cal also select if I want to get emails
>>> to notify answers when it's my first post in a discussion page, on
>>> that page I seem to get only the generic wiki editing interface.
> I guess if there is a DokuWiki plugin for that it's possible. I'll look into it.
>
>>> Also, it would be cool to get email notifications about any page
>>> modification to pages I subscribed or have chosen somehow too, I
>>> didn't find anything to set that.
> Again, I guess we have to resort to a plugin here - and it should
> probably not be the default to receive mails.
>
Thanks, these are crucial features for a modern wiki, most would-be 
contributors will expect them to be there and working.

-Alberto