[OpenWrt-Devel] Firewall Documentation

[Alberto Bursi]

On 10/08/2018 16:39, Dave Turvene - Work wrote:
> On 09/08/2018, Alberto Busi wrote:
>> Yeah I saw that. Wiki maintainers are notified of each edit in the wiki.
>> Looks good, follows wiki guidelines.
>> I cannot say how good it actually is, as I don't know much about manual
>> firewall usage.
>>
>> That said, many thanks for volunteering to do a cleanup, I know it's not
>> trivial,
>>   ?and it needs someone that actually *knows* how to use the firewall in
>> the first place,
>> which isn't a so common skill apparently.
>>
>> I'd say you can go ahead, afaik there is nothing that really *needs* to
>> be saved in the firewall section.
>>
>> Pretty much all current firewall documentation was cloned from the old wiki
>> (which is now the read-only wiki.openwrt.org), and was at best split up
>> or re-arranged a bit by me.
>> You can easily check this for yourself, if it's already in the old wiki
>> (and it's obsolete stuff) it can be safely removed.
>>
>> People can still access the original legacy info from the old read-only
>> wiki,
>> if they need legacy info.
>>
>> -Alberto
> Yes, I see all the content was moved from wiki.openwrt.org to openwrt.org/docs but organized a lot better.
>
> I suggest there is still too much mixing of firewall3 configuration, iptables configuration along with too much archane/confusing background information.  I would like to re-partition the firewall section into
> * pure firewall3 concepts (e.g. iptables interface), setup and examples,
> * iptables concepts (user-side, kmods, procfs), setup and examples,
> * miscellaneous (e.g. future nftables/nf_tables support, third-party iptable builders).
>
> I think everything in the current firewall docs can go into one of these sections or be discarded.
>
> The easiest for me would be to have access to the openwrt.org docs filesystem to move/edit the markup files.  I'm also willing to provide an structure outline so that you/etc can lay out the structure.
>
> But first, I'm upgrade from 17.01.5 to 18.06.0 on my testing router...
>
> David Turvene
>
>
> _______________________________________________
> openwrt-devel mailing list
> openwrt-devel at lists.openwrt.org
> https://lists.openwrt.org/mailman/listinfo/openwrt-devel

I sent an archive with the txt files from the firewall wiki 
namesapce/folder (which are the "page source" you see in the editor) 
from the server. I used another email address as Gmail does not allow 
archive attachments.

I think you can create the new firewall folder structure yourself in 
some other place that is not accessible directly, for example inside the 
inbox namespace (it can be seen through the "site map" page 
https://openwrt.org/inbox?do=index  and was meant as a place for 
"in-progress" articles that aren't ready to be seen by everyone)

You could place all the new firewall documentation under 
https://openwrt.org/inbox/firewall (which currently does not exist), as 
creating new pages in arbitrary places does not require admin access.

When you're done just notify me or tmomas and we will move it over and 
replace the current firewall documentation.

-Alberto


_______________________________________________
openwrt-devel mailing list
openwrt-devel at lists.openwrt.org
https://lists.openwrt.org/mailman/listinfo/openwrt-devel