FlightGear wiki:Instant-Refs: Difference between revisions

Jump to navigation Jump to search

FlightGear wiki:Instant-Refs (view source)

Revision as of 18:49, 2 May 2016

3,058 bytes removed ,  2 May 2016
→‎On Quoting: Dequoted
m (→‎The Script: change to use https in prepend() transformations, dbLog simplification, chronological list of contributors)
(→‎On Quoting: Dequoted)
Line 118: Line 118:
If you want to suggest a new feature/improvement, or have discovered a bug, please add details to the [[#Issues/limitations|Issues/limitations]] or [[#Feature requests & ideas|Feature requests & ideas]].
If you want to suggest a new feature/improvement, or have discovered a bug, please add details to the [[#Issues/limitations|Issues/limitations]] or [[#Feature requests & ideas|Feature requests & ideas]].


== On Quoting ==
== On quoting ==
{{Main article|FlightGear wiki:Quoting Guidelines}}
{{Main article|FlightGear wiki:Quoting Guidelines}}


{{FGCquote
Using the Instant-Cquotes script is a good way to bootstrap and write some preliminary notes; however, while they might be useful to understand how undocumented subsystems and features work and are definitely better than nothing, they are not meant to replace proper, structured and well-written wiki articles.<ref>{{cite web
|1= The quotes are a good way to bootstrap a missing article, but they need to be slowly replaced and the article properly structured.  Have a look at what I did with the [[FGAddon|FGAddon article]] as an example.  This was originally [[index.php?title=FGAddon&amp;oldid=87128|mainly quotes]].  I would simply suggest adding an intro paragraph to the very start, with the basic command line launcher option, as an easy initial improvement.  Such small improvements will add up in the long term and improve our wiki significantly.
| url    = http://forum.flightgear.org/viewtopic.php?p=282800#p282800
|2= {{cite web
| title  = <nowiki>Re: What is the QT launcher?</nowiki>
  | url    = http://forum.flightgear.org/viewtopic.php?p=282800#p282800
| author = <nowiki>bugman</nowiki>
  | title  = <nowiki>Re: What is the QT launcher?</nowiki>
| date  = Apr 17th, 2016
  | author = <nowiki>bugman</nowiki>
| added  = Apr 17th, 2016
  | date  = Apr 17th, 2016
| script_version = 0.25
  | added  = Apr 17th, 2016
}}</ref>
  | script_version = 0.25
  }}
}}


{{FGCquote
One way to convert pages bootstrapped using quotes is to extract relevant information from them and keep citations only as references; in case important details are missing, they can be asked for on the [[Mailing lists|mailing lists]] (on the forum, the chance to get a complete answer might be lower).<ref>{{cite web
|1= One option might be to move the quotes to the Talk page for each entry. That way the quotes themselves wouldn't be lost if anyone wished to refer to them and to form the basis of future content, but they wouldn't clog up the pages themselves.
| url    = http://sourceforge.net/p/flightgear/mailman/message/34954385/
|2= {{cite web
| title  = <nowiki>Re: [Flightgear-devel] Wiki Quotes</nowiki>
  | url    = http://sourceforge.net/p/flightgear/mailman/message/34948989/
| author = <nowiki>James Turner</nowiki>
  | title  = <nowiki>Re: [Flightgear-devel] Wiki Quotes</nowiki>
| date  = Mar 21st, 2016
  | author = <nowiki>Stuart Buchanan</nowiki>
| added  = Mar 21st, 2016
  | date  = Mar 19th, 2016
| script_version = 0.25
  | added  = Mar 19th, 2016
}}</ref> Another option might be moving the quotes to the Talk page for each entry, which would preserve the sources without clogging up the articles.<ref>{{cite web
  | script_version = 0.25
| url    = http://sourceforge.net/p/flightgear/mailman/message/34948989/
  }}
| title  = <nowiki>Re: [Flightgear-devel] Wiki Quotes</nowiki>
}}
| author = <nowiki>Stuart Buchanan</nowiki>
 
| date  = Mar 19th, 2016
{{FGCquote
| added  = Mar 19th, 2016
|1= use of quotes is just an easy way to summarize the current development state of the undocumented subsystems while some actual documentation is made
| script_version = 0.25
|2= {{cite web
}}</ref>
  | url    = http://sourceforge.net/p/flightgear/mailman/message/34950258/
  | title  = <nowiki>Re: [Flightgear-devel] Wiki Quotes</nowiki>
  | author = <nowiki>Alessandro Menti</nowiki>
  | date  = Mar 20th, 2016
  | added  = Mar 20th, 2016
  | script_version = 0.25
  }}
}}
{{FGCquote
|1= It's not the best way of documenting things by far, but it is slightly better than nothing I guess.
|2= {{cite web
  | url    = http://sourceforge.net/p/flightgear/mailman/message/34950336/
  | title  = <nowiki>Re: [Flightgear-devel] Wiki Quotes</nowiki>
  | author = <nowiki>Erik Hofman</nowiki>
  | date  = Mar 20th, 2016
  | added  = Mar 20th, 2016
  | script_version = 0.25
  }}
}}
 
{{FGCquote
|1= It's not that the material is generally worthless - it's a question of signal to noise.
|2= {{cite web
  | url    = http://forum.flightgear.org/viewtopic.php?p=280058#p280058
  | title  = <nowiki>Re: quoting on the wiki</nowiki>
  | author = <nowiki>Thorsten</nowiki>
  | date  = Mar 21st, 2016
  | added  = Mar 21st, 2016
  | script_version = 0.25
  }}
}}
 
{{FGCquote
|1= The basic problem is not the quotes it is the lack of decent documentation that would make the quotes redundant.
|2= {{cite web
  | url    = http://forum.flightgear.org/viewtopic.php?p=280065#p280065
  | title  = <nowiki>Re: quoting on the wiki</nowiki>
  | author = <nowiki>Richard</nowiki>
  | date  = Mar 21st, 2016
  | added  = Mar 21st, 2016
  | script_version = 0.25
  }}
}}
{{FGCquote
|1= Quotes are considerably better than nothing, and usually a poor substitute for good documentation. I'm grateful for whoever has spent the time doing this as it has helped me.
|2= {{cite web
  | url    = http://forum.flightgear.org/viewtopic.php?p=280065#p280065
  | title  = <nowiki>Re: quoting on the wiki</nowiki>
  | author = <nowiki>Richard</nowiki>
  | date  = Mar 21st, 2016
  | added  = Mar 21st, 2016
  | script_version = 0.25
  }}
}}
 
{{FGCquote
|1= I have always considered such quotes to be a "compromise", i.e. the foundation for bootstrapping/writing new documentation, rather than a replacement for it.
In some cases, that has worked out exceptionally well, in others, it frankly hasn't at all. But at the end of the day, it's also a pain/gain matter
|2= {{cite web
  | url    = http://forum.flightgear.org/viewtopic.php?p=280070#p280070
  | title  = <nowiki>Re: quoting on the wiki</nowiki>
  | author = <nowiki>Hooray</nowiki>
  | date  = Mar 21st, 2016
  | added  = Mar 21st, 2016
  | script_version = 0.25
  }}
}}
 
{{FGCquote
|1= the best way to create documentation is to ask questions here (not on the forum!) in terms of getting a good answer rather than many potentially confusing ones. I’m aware there’s a cultural gap here between people who prefer email or web-based modes of communication, though.
|2= {{cite web
  | url    = http://sourceforge.net/p/flightgear/mailman/message/34954385/
  | title  = <nowiki>Re: [Flightgear-devel] Wiki Quotes</nowiki>
  | author = <nowiki>James Turner</nowiki>
  | date  = Mar 21st, 2016
  | added  = Mar 21st, 2016
  | script_version = 0.25
  }}
}}


== Changelog ==
== Changelog ==
Elgaton
329

edits

Retrieved from "https://wiki.flightgear.org/Special:MobileDiff/97671"

Navigation menu