Jeremy Davis's picture

I actually thought there were docs missing at some point in the past. That is until I realised that the site-to-site docs covered both OpenVPN server and OpenVPN client (which are both TurnKey OpenVPN servers just to confuse things...)

What I really need to do is sit down with it and set it up myself from scratch and test it out. Then I can be a bit more confident on updating the docs...

But I still think that the tun device creation would be good to add to the LXC containers (and probably docker too) so at least then it will work.

Regarding you 'just' "rub[bing] a few documents together", yeah ok that is somewhat true. But if you hadn't posted and bought that info to my attention, then we wouldn't be able to make the improvement for the benefit of future users (once we update it). So from one perspective, it was a small thing you did (i.e. collecting and sharing information); but from another, your actions will likely have the biggest impact down the line! So you deserve all the recognition I gave you! :)

Docs are an ongoing issue for any small open source project. For us behind the scenes, there are so many jobs that need doing and so few resources. We almost always have "more important" (i.e. higher priority) tasks to take care of, so docs often get neglected. It's also hard to get developers motivated to write up good docs (most developers find them boring and tedious).

As for community volunteers; as a general rule, those that need the docs don't have the knowledge to create them. Those that have the knowledge, don't have the interest, time or energy. So it's a bit of a vicious cycle really.

Anyway, thanks again for you input. And if you did want to document anything, then our docs section (of the website) is actually a wiki. The dedicated OpenVPN appliance docs page is here. You'll need to be logged in, but you should be able to edit that if you wish. You can also make changes to the docs on GitHub, although you'll need a (free) GitHub account to do that. Our "gitflow" is noted here but please feel free to ask if you need more guidance.

Good luck with it all! :)