firewall4, the wiki, etc.

[Philip Prindeville]

> On Apr 27, 2026, at 10:32 PM, Jonas Lochmann <openwrt at jonaslochmann.de> wrote:
> 
> Am Mon, Apr 27, 2026 at 01:12:51PM -0600, schrieb Philip Prindeville:
>> Speaking of limitations, Confluence allows one to add comments at the
>> bottom of the page so that corrections can be made, examples enriched,
>> etc.  Our Wiki platform doesn't do that.
> 
> There are many possible tools and workflows. I do not see an issue in
> the tooling, but in missing processes.
> 
>> It would be nice, at a minimum, to have a button to be able to send an email to the page owner(s).
> 
> Does the page owner react just because there is a mail?


I can't speak for all contributors, but as someone who owns a couple of pages himself, it would depend on the nature of the message and how diligent I was.


> 
>> When we made the switch from firewall3 to firewall4 a lot of the Wiki content didn't keep up...
> 
> That's the main problem. Often, there is no real documentation and the
> wiki can not be considered the documentation. I understand why OpenWrt
> does not use traditional manpages, but keeping the documentation next
> to the source code (versioned with it) is something I consider
> helpful.


I think in many cases a sample config would be handy.

And I would like to see the `config` file contents themselves and not the `uci set ...` commands because those don't always work correctly.