On Thu, Jan 04, 2018 at 02:17:51PM +0000, Andreas Thulin wrote: > Hi all! > > Thought I'd create an OpenBSD wiki somewhere, where anyone (especially > non-developers like myself) could create and edit tutorials for stuff > non-developers like myself would find useful. I find that sometimes > existing tutorials become outdated, and was thinking that a wiki would make > updates easier. > > Before I go and create anything - are there already a place similar to what > I'm describing, where I could get myself involved? (I'm too junior to start > suggesting changes and updates to the docs on OpenBSD.org, and I'm not sure > they should be used for what I want to achieve.) > > I know this comes out as yet another "let's start another project no one is > asking for", but please be gentle with flaming me - I honestly want to > contribute to the community to the extent of my abilities. > > Cheers, > Andreas
Your idea, at first glance, sounds like a wonderful thing. Genuinely. But before you get your hopes up, go check out the various worldwide community groups websites with similar attempts. Mexico, Russia, etc. You will find the same thing. Instructions for something to do with 5.7, all of which is no longer applicable do to the constant change in OpenBSD. Writing articles is not too difficult. Updating them, just doesn't happen. Seriously, will I really want to spend the time updating an article about something I now thoroughly understand and which has changed? Or would I really just prefer to watch the latest movie that looks good? It's just human nature. If you really want to see something kept up to date, it really needs to be within the tree of the system. As changes happen (or happened a long time ago) the manual pages don't always reflect reality well. I would put some effort into that. If you see something in a manual page that is just beyond you, ask about that and see if you can write a diff to make things more clear. I find that some manual pages would be really more helpful with just one or two examples added. Trust me, there are many manual pages with flaws. You are naturally going to read every manual page for all of the commands within /bin and /sbin, right? Trying to form a community project outside just doesn't seem to work, sadly. But if you've got the desire to do something, then have at it. Just don't do a ton of hard work only to be disappointed. Have fun, Chris Bennett
