Difference between revisions of "Documentation Talk:User Guide"

From VideoLAN Wiki
Jump to navigation Jump to search
Line 17: Line 17:
 
::::--[[User:Jeremy Butler|Jeremy Butler]] 20:26, 9 July 2007 (CEST)
 
::::--[[User:Jeremy Butler|Jeremy Butler]] 20:26, 9 July 2007 (CEST)
 
:::::I'd rather have the copyright notice right after the title (seems to be the way it's done in most manuals online). And maybe change it from (c) VideoLAN project to (c) VideoLAN project and it's contributors [[User:Dionoea|Dionoea]] 09:48, 10 July 2007 (CEST)
 
:::::I'd rather have the copyright notice right after the title (seems to be the way it's done in most manuals online). And maybe change it from (c) VideoLAN project to (c) VideoLAN project and it's contributors [[User:Dionoea|Dionoea]] 09:48, 10 July 2007 (CEST)
 +
::::::I defer to your judgment, but you might take a look at how Gallery handles its wiki-based documentation: http://codex.gallery2.org/Gallery2:About
 +
::::::It's got a discrete notice of the ''GNU Free Documentation License'' in the footer: "Content is available under GNU FDL."  The FDL replaces the copyright notice.
 +
::::::Also, in the US, I don't know that a group like the contributors can legally hold copyright, but I'm no lawyer. --[[User:Jeremy Butler|Jeremy Butler]] 13:15, 10 July 2007 (CEST)
  
 
== Original authors ==
 
== Original authors ==

Revision as of 11:15, 10 July 2007

Import from the original doxygen documentation is finished. You can start editing it. Enjoy! Dionoea 11:12, 7 November 2006 (CET)

Formatting: Put authors' names in the discussion page

I'd suggest de-emphasizing the authors of this article. For one, this will change as more authors edit this wiki. In a sense they are credited in the article's history page, but, of course, the basic principle of a wiki is that the authors are relatively anonymous.

But my suggestion is mostly based on what a reader wants to know. He/she is not so much interested in the authors as in getting information. Hence, I'd suggest the information come first in this, and all other articles, and the authors, if they need to be listed at all, be moved to the discussion pages.

Just my 2 cents...

--Jeremy Butler 17:14, 9 July 2007 (CEST)

I agree. This is mainly legacy from the old documentation (I didn't really change the layout when importing the docbook into the wiki). -- Dionoea 17:53, 9 July 2007 (CEST)
I made the changes. Also, the GPL notice is duplicated in various templates. Perhaps it and the copyright notice should be moved to the footer. I believe that MediaWiki gives you the option of automatically inserting a GPL notice.
Where is it duplicated? AFAIK it's only automatically inserted if you use the Documentation template (at least that's how I planed it to work). Dionoea 18:44, 9 July 2007 (CEST)
Documentation:Play HowTo had it both in the template and it was at the top of the page, right after a copyright notice. I moved it to the bottom of the page, beneath the template. Based on what you've said here, I have now deleted it. If you check the history for the page, you'll see what I mean.
Also, can the copyright notice be moved into the footer?
--Jeremy Butler 20:26, 9 July 2007 (CEST)
I'd rather have the copyright notice right after the title (seems to be the way it's done in most manuals online). And maybe change it from (c) VideoLAN project to (c) VideoLAN project and it's contributors Dionoea 09:48, 10 July 2007 (CEST)
I defer to your judgment, but you might take a look at how Gallery handles its wiki-based documentation: http://codex.gallery2.org/Gallery2:About
It's got a discrete notice of the GNU Free Documentation License in the footer: "Content is available under GNU FDL." The FDL replaces the copyright notice.
Also, in the US, I don't know that a group like the contributors can legally hold copyright, but I'm no lawyer. --Jeremy Butler 13:15, 10 July 2007 (CEST)

Original authors

The original authors of this documentation were:

  • Alexis de Lattre
  • Anil Daoud
  • Benjamin Pracht
  • Clément Stenac
  • Jean-Paul Saman
  • Antoine Cellerier