[LEDE-DEV] Documentation for router support means the famous Table of Hardware

[Jan-Tarek Butt]

>> On 09/08/16 11:08, Russell Senior wrote:
>>>>>>>> "Eric" == Eric Schultz <eschultz at prplfoundation.org> writes:
>>>
>>> Eric> I think the idea of having the hardware support documentation
>>> Eric> managed by experts is a good idea. Non-experts can, and should,
>>> Eric> have plenty of areas to contribute but I don't see this area as
>>> Eric> one of them.
>>>
>>> I want to push back on this a little bit.  Jimmy Wales had similar
>>> ideas, once upon a time (see https://en.wikipedia.org/wiki/Nupedia), and
>>> he was proven wrong, empirically.  The beauty of wikis is that people
>>> are empowered to contribute what they know.  Without that empowerment,
>>> the vehicles for sharing what they know is much more scattered and
>>> diffused.  Yes, wikis are a shit storm of inconsistency.  If people want
>>> more consistency what is really needed is people to garden the manure
>>> into neat rows.  I can't begin to count the vast utility I have derived
>>> from the steaming heaps of barely coherent crap that has been dumped
>>> into OpenWrt wiki.  If you close that vehicle off, what you will end up
>>> with is a whole lot of nothing, which I argue is vastly worse.
>>>
>>> If you want something that's pretty, hire someone to watch RecentChanges
>>> and clean stuff up.  If the experts had the time and raw information to
>>> do it, we wouldn't be talking about this.  The reality is that they
>>> don't.  I argue for letting the rabble continue to contribute as they
>>> can.  If you don't like what it looks like, that discomfort is trying to
>>> tell you what to do next: click the edit button and make it better.
>>
>> My main idea was to automate more parts.
>> With asciidoc it is quiet easy to generate site out of lede source.
>>
>> We can do the same for wiki side. I do that here:
>> https://wiki.nordwest.freifunk.net/Router/Hardware
>>
>> So maybe we can generate wiki tables out of source.
> 
> what about having an auto-generated section and a free-editable part so that users can add information? Like “have the cake and eat it too” ;)
> Also I believe the current ToH also contains pages for unsupported devices (which is worthwhile to have, if only to understand why to avoid certain models), how would you autocreate not yet supported models or models whose support is still happening outside the main tree?

oh the wiki sites I am currently not shure how we can generate content on the sites.
Its also depence on witch wiki software we use. On nordwest.freifunk.net we currently
use moinmoin wiki wich is realy awful...

But can create macros for many thinks. as an example:

For download links we can build a abstract macro

download(url,"suffix", version);

download("https://downloads.lede-project.org","tl-wr841","stable");

cheers
Tarek

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 801 bytes
Desc: OpenPGP digital signature
URL: <http://lists.infradead.org/pipermail/lede-dev/attachments/20160908/b6c7a9b0/attachment.sig>