[LEDE-DEV] A Wiki for LEDE Documentation

[Josh Farwell]

Hello Folks!

I'm new to this project and excited to be here. I used to work for the
Linux Foundation as a sysadmin where part of my job was to curate and
run infra for the wikis of several open source projects sponsored by
the LF.

I am no longer employed or associated with them, but I would love to
contribute to a project and I am excited about LEDE. I am willing to
pitch in and help with the wiki.

Dokuwiki is what I would highly recommend as well; I like its markup
language and I REALLY like the access control options, which Mediawiki
simply doesn't support without poorly maintained extensions.

My main question at this point is how much of the existing OpenWRT and
other Linux documentation can be ported in to a LEDE wiki? If I'm not
mistaken, there's generally feature parity between OpenWRT and LEDE
right now aside from LEDE having support for more devices. Can we
simply start porting the OpenWRT wiki over and edit, clean and make
corrections to the content?

I also feel like it's important to go into this project with a solid
goal in mind - some wikis, such as the PFSense wiki, are all about
accessible step-by-step instructions to set up common network and
application configurations with the distro's specific interfaces,
while explaining details about the different setups in an accessible
way. DD-WRT has similar documentation.

Is this a goal of the LEDE project? If it is, the wiki is a big
project and it will need a lot of care and feeding as things change,
and there are a lot of improvements that can be made on the existing
OpenWRT content. If it's instead meant to be a repository of
information about LEDE-specific features which are not common in other
Linux distributions, along with links to relevant documentation from
other projects which LEDE is leveraging, the wiki becomes simpler,
smaller, and easier to keep completely up-to-date, but less friendly
to newcomers.

-- Josh

On Fri, Sep 9, 2016 at 11:34 AM, Thomas Endt <tmo26 at gmx.de> wrote:
>> I recommend we use Dokuwiki as the primary means of maintaining the
>> LEDE documentation.
>
> That would be my first choice, too.
> However, if there is another wiki that has significant advantages over
> Dokuwiki, I wouldn't mind to try something new.
>
> One thing to keep in mind when chosing a new wiki software: At least two
> people are needed that bring some knowledge about this software with them.
>
>
> _______________________________________________
> Lede-dev mailing list
> Lede-dev at lists.infradead.org
> http://lists.infradead.org/mailman/listinfo/lede-dev



-- 
Josh Farwell
#971-235-4868
josh.farwell at gmail.com