Author |
Message |
puppian

Joined: 18 Jul 2005 Posts: 538 Location: PuppyLand
|
Posted: Sat 19 Nov 2005, 11:39 Post subject:
Attribution; what do you think? |
|
This post about 'reward' reminds me this. Should we let people include their name and email in the docs they wrote, like what the Linux documentation project does?
For example,
http://www.tldp.org/docs.html#howto
http://www.ibiblio.org/pub/Linux/docs/HOWTO/other-formats/html_single/
http://www.ibiblio.org/pub/Linux/docs/HOWTO/other-formats/html_single/3-Button-Mouse.html
Contributors who aren't joining the docs committee may want their name appear somewhere
Btw, I think I have seen in other docs project something like 'these docs are under xxx license'. I'm no good at that, so do we need that?
_________________ Puppylinux.org - Community home page of Puppy Linux hosted by Barry (creator of Puppy), created and maintained by the Puppy Linux Foundation since 2005
|
Back to top
|
|
 |
Ian
Official Dog Handler

Joined: 04 May 2005 Posts: 1238 Location: Queensland
|
Posted: Sun 20 Nov 2005, 18:32 Post subject:
|
|
Yes I think credit should be given to all who contribute to this project.
And I'm not sure about the license part.
|
Back to top
|
|
 |
J_Rey

Joined: 04 May 2005 Posts: 274 Location: Northwest Florida, U.S.A.
|
Posted: Sun 20 Nov 2005, 20:52 Post subject:
+1 |
|
Yesterday I spent a few hours categorizing the wiki (mostly done) to make it easier to find things for referring to when creating documentation pages (in addition to the Sitemap). Also, I submitted the CategoryDocumentation wiki page to DistroWatch until our site is ready (people are already visiting there). So my categorizing the pages had another specific purpose.
I was thinking about, for my contribution, eventually starting out with having a related links/contributors section at the bottom of each documentation page that has links to related wiki, pupweb, and forum pages (and other sources like Barry's offline Help pages included with Puppy) that would be helpful for anyone to refer to when creating pages, and also would serve to show where the source of the info was and also include the authors in some way. We should have a standard template/format for this and the other page sections also.
|
Back to top
|
|
 |
brad_chuck
Joined: 15 Aug 2005 Posts: 284 Location: Appalachian Mountains
|
Posted: Mon 21 Nov 2005, 13:31 Post subject:
A Thought |
|
What about letting people put there name after the part they write and then making that a link to a page that tells the emails of all the people that contributed.
This would be great for people that would like to add more than there email(websites or AIM). Or if there email changed they would not have to look up all the pages they edited they could just edit the one page with the names on it.
|
Back to top
|
|
 |
mayakovski

Joined: 19 Nov 2005 Posts: 124 Location: Comox, BC, CANADA
|
Posted: Sat 26 Nov 2005, 14:00 Post subject:
|
|
Hi All;
These are all great ideas and thoughts.
One issue I can see is how do you deal with documentation that is a derivative of someone else's original work? I am currently working on putting some docs into the install section but they are my rewording (mostly) of other docs in the HowTo section of the forum.
At what point do my changes make the document my own? Similar to the issue artists and musicians often have when creating work from other peoples work.
Maybe listing the names, if known, of all people who had a hand in the original work. Some kind of sudo credit/disclaimer at the bottom of each document. IE.
"This document is a collection of ideas and knowledge contributed to by blah, blah, blah."
Puppy Linux Documentation Project.
This works both ways, if you and only you created the document then yours is the only name listed. Otherwise any known people are listed. We could also have a disclaimer listed somewhere stating that if you find documentation that you contributed to and you are not listed, provide us with an example proving you created part of the work and we will add you in to the list, baring that we could just rewrite that section.
_________________ Mayakovski
**********************
Puppy Linux | Barking Up The Right Tree
Compaq Armada 1580DMT | P150, 49MB RAM - 3.2 GB HD, Puppy 1.0.6
Compaq Deskpro EN | P3-733, 384 MB RAM - 80GB HD, Puppy 1.0.7
|
Back to top
|
|
 |
puppian

Joined: 18 Jul 2005 Posts: 538 Location: PuppyLand
|
Posted: Sat 26 Nov 2005, 15:40 Post subject:
|
|
>Maybe listing the names, if known, of all people who had a hand in the original work. Some kind of sudo credit/disclaimer at the bottom of each document. IE.
How about something like this
Title of the docs page
Name of author, Contact method(s)
Content
Content
Page last edited by AAA, Contact method(s), 27 Nov 2005.
References:
Forum post A by user XX - some descriptions if needed.
Article B by user YY - some descriptions if needed.
_________________ Puppylinux.org - Community home page of Puppy Linux hosted by Barry (creator of Puppy), created and maintained by the Puppy Linux Foundation since 2005
|
Back to top
|
|
 |
mayakovski

Joined: 19 Nov 2005 Posts: 124 Location: Comox, BC, CANADA
|
Posted: Sat 26 Nov 2005, 15:47 Post subject:
|
|
puppian wrote: |
Title of the docs page
Name of author, Contact method(s)
Content
Content
Page last edited by AAA, Contact method(s), 27 Nov 2005.
References:
Forum post A by user XX - some descriptions if needed.
Article B by user YY - some descriptions if needed. |
I think that works quite well, it seems to cover the bases and is elegant as well. I think that would keep everyone happy. It gets my vote.
_________________ Mayakovski
**********************
Puppy Linux | Barking Up The Right Tree
Compaq Armada 1580DMT | P150, 49MB RAM - 3.2 GB HD, Puppy 1.0.6
Compaq Deskpro EN | P3-733, 384 MB RAM - 80GB HD, Puppy 1.0.7
|
Back to top
|
|
 |
puppian

Joined: 18 Jul 2005 Posts: 538 Location: PuppyLand
|
Posted: Tue 29 Nov 2005, 14:42 Post subject:
|
|
I have added the things mentioned above to this page:
http://puppylinux.org/docs/pre/?Getting_Started:Window_Managers:IceWM
(that page was written long time ago and I can't remember the references )
Is everyone ok with that? If so, I'll be making a new thread to tell people about this so that those who aren't joining the committee but still want to contribute will know how to include their names, etc
_________________ Puppylinux.org - Community home page of Puppy Linux hosted by Barry (creator of Puppy), created and maintained by the Puppy Linux Foundation since 2005
|
Back to top
|
|
 |
mayakovski

Joined: 19 Nov 2005 Posts: 124 Location: Comox, BC, CANADA
|
Posted: Tue 29 Nov 2005, 14:54 Post subject:
|
|
Looks good to me.
I'll start using this format today. I think this will keep everyone happy. And isn't that one of the best things about puppies...
_________________ Mayakovski
**********************
Puppy Linux | Barking Up The Right Tree
Compaq Armada 1580DMT | P150, 49MB RAM - 3.2 GB HD, Puppy 1.0.6
Compaq Deskpro EN | P3-733, 384 MB RAM - 80GB HD, Puppy 1.0.7
|
Back to top
|
|
 |
Flash
Official Dog Handler

Joined: 04 May 2005 Posts: 12819 Location: Arizona USA
|
Posted: Tue 29 Nov 2005, 17:00 Post subject:
|
|
puppian wrote: | ...I'll be making a new thread to tell people about this so that those who aren't joining the committee but still want to contribute will know how to include their names, etc  | Remember that only PLDP Usergroup members can view the PLDP forum.
|
Back to top
|
|
 |
puppian

Joined: 18 Jul 2005 Posts: 538 Location: PuppyLand
|
Posted: Wed 30 Nov 2005, 04:28 Post subject:
|
|
Thanks Flash
yes that new thread would be in the 'Puppy Power' forum.
_________________ Puppylinux.org - Community home page of Puppy Linux hosted by Barry (creator of Puppy), created and maintained by the Puppy Linux Foundation since 2005
|
Back to top
|
|
 |
puppian

Joined: 18 Jul 2005 Posts: 538 Location: PuppyLand
|
Posted: Wed 07 Dec 2005, 15:49 Post subject:
|
|
The final template is here
http://www.murga.org/~puppy/viewtopic.php?t=4372
It's also in the sticky welcome post of this forum.
_________________ Puppylinux.org - Community home page of Puppy Linux hosted by Barry (creator of Puppy), created and maintained by the Puppy Linux Foundation since 2005
|
Back to top
|
|
 |
raffy
Joined: 25 May 2005 Posts: 4839 Location: Manila
|
Posted: Wed 07 Dec 2005, 19:16 Post subject:
Template |
|
Hope that template is also available at the DOCS site
|
Back to top
|
|
 |
puppian

Joined: 18 Jul 2005 Posts: 538 Location: PuppyLand
|
Posted: Thu 08 Dec 2005, 14:14 Post subject:
|
|
Sure!
http://puppylinux.org/docs/pre/?TEMPLATE
_________________ Puppylinux.org - Community home page of Puppy Linux hosted by Barry (creator of Puppy), created and maintained by the Puppy Linux Foundation since 2005
|
Back to top
|
|
 |
|