Hi Eric, Eric Furman wrote on Sun, Nov 16, 2014 at 09:18:06PM -0500: > On Sun, Nov 16, 2014, at 12:50 AM, Ingo Schwarze wrote: >> andrew fabbro wrote on Sat, Nov 15, 2014 at 04:34:35PM -0800:
>>> What about writing tutorials/articles? >> That is most definitely *not* a job for beginners. >> Writing good tutorials requires much more expertise and >> experience than writing reference documentation or >> hunting for bugs. >>> There's www.openbsdsupport.org which I believe is officially blessed >> Not at all. It is completely unofficial, i didn't even know about it, >> and a brief look gives me the impression that most of the content is >> probably completely outdated. Besides, i haven't ever heard of most >> of the authors, so i doubt the content could be trusted in the first >> place. >> >> I'd strongly advise against using that site for anything. > You could submit something to undeadly.org. Sure, but note that it's a news portal, not a documentation repository. It organizes content chronologically, not by topic, and it never updates published content that gets outdated, so searching it for documentation is relatively hard and likely to return outdated stuff, in particular since it mostly reports on brand new things, often before they have fully stabilized. We strongly believe in the principle "all documentation should be in one place" - to make it easy to find for users, easy to maintain for developers, and easy to use by following a consistent style. For reference documentation, that place is the manual pages. For all other documentation that doesn't fit into manuals, that place is the FAQ on the OpenBSD web site. So, to improve documentation, submit patches to manual and FAQ pages. Don't put up your own documentation snippets, neither on Undeadly nor elsewhere on the web. > BTW, is undeadly.org an official OBSD site? It is not a part of the OpenBSD project, but run by an independent group of Undeadly Editors who review submissions and post them, following a four-eye-principle for quality control. Some of the editors are also OpenBSD developers and many OpenBSD developers submit content to Undeadly now and then. Not all articles are perfect, but neither are all commits. In any case, the OpenBSD project encourages using Undeadly. In particular, developers are encouraged to post hackathon reports on Undeadly. Yours, Ingo
