Haproxy how-tos no longer available

Started by ddt3, September 05, 2023, 05:45:25 PM

Previous topic - Next topic
In this page: https://docs.opnsense.org/manual/reverse_proxy.html, the documentation references Haproxy How-Tos: https://docs.opnsense.org/manual/how-tos/haproxy.html
But those How-Tos no longer exist.

This is also true for the web interface of the haproxy plugin, it refers to the same non-existent howtos.

This basically means that at the moment there is no opnsense haproxy documentation at all


HAProxy plugin went through 4 major iterations. I'm not sure which version the docs that a core dev wrote (not the maintainer) referred to, but as such the information given wasn't matching reality anymore. So it was removed again.


Cheers,
Franco
"AI has absolutely reduced the cost of creating technical debt." -- ChatGPT

That's a pity.
Because I can of course read the original HAproxy documentation, but that documentation describes how to use HAproxy config  files and does not explain where to look in the opnsense UI.

I would be more than willing to create a pull request for updated documentation but that means that first I need to understand it myself :-)

It might be good to ask the maintainer beforehand if he intends to change it again and/or if he could help with getting the docs ready. Without this component I fear it will be another wasted effort.


Cheers,
Franco
"AI has absolutely reduced the cost of creating technical debt." -- ChatGPT

September 14, 2023, 12:46:52 AM #5 Last Edit: September 14, 2023, 12:51:47 AM by fraenki
Plugin maintainer here. I don't plan another overhaul of the HAProxy plugin GUI. ;D So if anyone wants to start building a documentation, yes, please go ahead. Or if you think that some information could be added to one of the "introduction" pages, please submit your suggestion on GitHub...

I may review documentation (GitHub pull requests), but I can't put any effort into writing documentation in the foreseeable future. That being said, there's some good documentation out there...

Ciao
- Frank