On Thu, Dec 20, 2018 at 10:13:11AM +0100, Aham Brahmasmi wrote: > Hi Gilles, >
Hi, > Thank you for your elaborate response. > > > if someone steps up to do the work, I will happily welcome the FAQ again > > but it needs to be someone who commits to that work, not someone that'll > > write the pages dump them once and disappear. > > From what I understand, the primary requirement for a -current FAQ is > consistent maintenance of the FAQ. A secondary requirement is to > constantly evaluate the need of / interaction with external software > components viz. spamd, dkim-proxy, dovecot et al. > You understood primary requirement well. The secondary requirement isn't really to constantly evaluate all of the external software OpenSMTPD can possibly interact with, but to make sure that if the FAQ provides example of interaction with third-party project then these examples are maintained up-to-date. This isn't too hard really, we could setup a repository for the FAQ, the maintainer would do most of the work to maintain it up to date, then the community can push pull requests when there's need to fix it. What I don't want is that someone dumps a first version then disappears, and I get to keep updating the FAQ whenever I update a man page, I don't want to do the same work twice. > Currently I am not in a position to pick up the FAQ maintainership or > contribute in a meaningful way. I am sorry for that. > No worries, I can understand, I'm not in a position to do that myself. > Having said that, just in case someone thinks they could take up the FAQ > maintainership, would it be possible for you to please share the outline > of the expectations from an FAQ maintainer? > Sure. 0- come up with an initial version of the FAQ. 1- the FAQ _on the website_ should only document the last stable release 2- the FAQ _in development_ should document features being committed, in preparation for the next stable release 3- every six months, prior to the OpenSMTPD release, the development FAQ is evaluated to make sure it is accurate 4- in between, keep improving the FAQ with relevant information and make sure that issues reported by the community are fixed That's about all, it's not tricky but it requires commitment. It could be a joint effort between multiple people. -- Gilles Chehade @poolpOrg https://www.poolp.org tip me: https://paypal.me/poolpOrg -- You received this mail because you are subscribed to [email protected] To unsubscribe, send a mail to: [email protected]
