Unix Technical Forum

Re: template for new documentation

This is a discussion on Re: template for new documentation within the mailing.openbsd.tech forums, part of the OpenBSD category; --> jasonmcintyre@f2s.com wrote: > On Sun, Apr 03, 2005 at 11:43:14AM +0200, Han Boetes wrote: >> I just wrote some ...


Go Back   Unix Technical Forum > Unix Operating Systems > OpenBSD > mailing.openbsd.tech

FAQ Members List Calendar Search Today's Posts Mark Forums Read
  #1 (permalink)  
Old 02-18-2008, 07:44 AM
Nick Holland
 
Posts: n/a
Default Re: template for new documentation

jasonmcintyre@f2s.com wrote:
> On Sun, Apr 03, 2005 at 11:43:14AM +0200, Han Boetes wrote:
>> I just wrote some documentation and I wanted to add a licensenote
>> and looked at the most logical place,
>> /usr/src/share/misc/license.template, and I didn't find a
>> template.
>>
>> So I made one. Modeled after the other template and a discussion
>> on misc@ long ago by Marc Espie if I'm not mistaken.
>>
>> I would like to suggest adding this text to the file
>> /usr/src/share/misc/doclicense.template
>>

>
> isn't `documentation' covered by the term `software' in this sense?
> jmc


When Joel@ and I switched the PF User's Guide to BSD license, I didn't
feel really comfortable using the word "software" for HTML code and the
text it generated, and made exactly that change. This wasn't a man page
closely tied to source code, it wasn't something in the src/ tree, so I
felt the one word change was appropriate.

HOWEVER, I can assure you, changing the word "software" to
"documentation" was by far the easiest part to figure out. I don't
think this is needed. At most, perhaps adding a line to the existing
license.template saying something like "'software' could be replaced
with 'documentation' if more appropriate" might be reasonable, but
duplicating that much text for a one word change doesn't seem right to me.

Further, I don't think we want a blanket "new documentation should be
this way" statement. Stuff in the src/ tree, sure. HOWEVER, the PF FAQ
is the only part of the OpenBSD www/ tree which is licenced at all
beyond simple copyright. I'm more-or-less demanding that new outside
contributions to the FAQ go in under BSD license, however the FAQ itself
is a long way from being "BSDed", as tracking down some of the people
who contributed what to it would be difficult, and probably not worth
the trouble to me or anyone else actively working on OpenBSD (we got
better things to do). I don't think you will EVER see large parts of
the website "BSDed", out of simple "we do NOT want to do that", it is
distributed under copyright law because that's the way we want to do it.


Nick.

Digg this Post!Add Post to del.icio.usBookmark Post in TechnoratiFurl this Post!
Reply With Quote
Reply


Thread Tools
Display Modes

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

vB code is On
Smilies are On
[IMG] code is On
HTML code is Off
Trackbacks are On
Pingbacks are On
Refbacks are On
Forum Jump


All times are GMT. The time now is 10:04 PM.


Powered by vBulletin® Version 3.6.5
Copyright ©2000 - 2008, Jelsoft Enterprises Ltd.
SEO by vBSEO 3.2.0
www.UnixAdminTalk.com