On Thu, 17 Oct 2019 at 18:09, KV5R <kv5r@...> wrote:
As a former industrial instrument technician (having calibrated thousands of things), followed by 4 years of writing procedures, I can tell you it isn't easy! as procedures need to be general enough to cover variables in use-cases, but specific enough to be useful. Indeed, as publisher of a rather large how-to web site, I still find users' sending questions of details not adequately covered, even on long and detailed articles I wrote 20 years ago.
In theory, a wiki is a very good answer to the very real problems of
having one person write and maintain all of the comprehensive
documentation for an open source project. The community can do a more
efficient job than a single person. For example, I might be interested
in the TDR aspects, so I might work on the TDR pages in the wiki.
Someone else is interested in the Smith Chart, and she works on those
pages. Someone else is interested in hardware mods, and he works on
those pages. You get the idea.
This is theoretical, because it seems very difficult to convince
community members (in any open source project) to maintain the wiki
pages they find interesting/in need of work.
--buck
