20,741
edits
FlightGear wiki:Instant-Refs: Difference between revisions
Jump to navigation
Jump to search
FlightGear wiki:Instant-Refs (view source)
Revision as of 21:29, 21 December 2015
, 21 December 2015→Background
| Line 28: | Line 28: | ||
This is why it is important for other developers/contributors to know who came up with a certain idea and who originally supported it, possibly months (or even years) after a discussion took place. Good ideas should not just be preserved, but accompanied by corresponding quotes, linking back to the original discussion, so that potential contributors can make up their own minds to determine if/how they want to get involved in some effort or not. | This is why it is important for other developers/contributors to know who came up with a certain idea and who originally supported it, possibly months (or even years) after a discussion took place. Good ideas should not just be preserved, but accompanied by corresponding quotes, linking back to the original discussion, so that potential contributors can make up their own minds to determine if/how they want to get involved in some effort or not. | ||
The Instant-Cquotes script is intended to help with this. It also allows people to easily reuse forum or mailing list announcements in wiki articles, e.g., to update the [[Next Changelog|changelog]], [[Next newsletter|newsletter]] or the [[Release plan/Lessons learned]] page. | Equally, documentation is usually lacking behind significantly - writing documentation from scatch takes even more time. However, there is often tons of useful information hidden in the archives (devel list, forum, issue tracker etc). People unfamiliar with FlightGear may however have a difficult time locating/filtering and identifying such information in a timely fashion, so that features seem basically undocumented to novice users. | ||
The Instant-Cquotes script is intended to help with this. It also allows people to easily reuse forum or mailing list announcements in wiki articles, e.g., to update the [[Next Changelog|changelog]], [[Next newsletter|newsletter]] or the [[Release plan/Lessons learned]] page, but also to bootstrap new articles/documentation, until a dedicated rewrite/article is finished. | |||
It does this by making it easy to copy & paste important discussions over to the wiki, without having to rewrite any text or manually put together a proper [[Template:Cquote|Cquote]]. It doesn't take more than a few seconds. | |||
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]]. | ||