Talk:Main Page/Archive/2006-2011: Difference between revisions
Hellosimon (talk | contribs) (cleanup and update) |
|||
Line 1: | Line 1: | ||
== Making the manual accessible via wiki software == | == Making the manual accessible via wiki software == | ||
On the other hand, I would recommend to also look into making "The Manual" editable via some sort of web based frontend, this would also ensure that people are able to easily contribute modifications to the manual, which is really the ultimate source for flightgear users. | On the other hand, I would recommend to also look into making "The Manual" editable via some sort of web based frontend, this would also ensure that people are able to easily contribute modifications to the manual, which is really the ultimate source for flightgear users. | ||
A possible approach might be to import the underlying LaTex sources in docbook format into some sort of docbook based wiki (i.e. http://sourceforge.net/projects/doc-book/). | A possible approach might be to import the underlying LaTex sources in docbook format into some sort of docbook based wiki (i.e. http://sourceforge.net/projects/doc-book/). | ||
As the manual is maintained in LaTex, is would be very hard to translate the wiki notes to include them in the manual. I suspect that this will be a "Won't Fix" as it is easier to copy and paste the text from the wiki and go from there. I am open to ideas though. [[User:Gorilla|Gorilla]] 06:33, 2 March 2008 (EST) | As the manual is maintained in LaTex, is would be very hard to translate the wiki notes to include them in the manual. I suspect that this will be a "Won't Fix" as it is easier to copy and paste the text from the wiki and go from there. I am open to ideas though. [[User:Gorilla|Gorilla]] 06:33, 2 March 2008 (EST) | ||
Line 18: | Line 8: | ||
Also, I feel there are some sections covered in the wiki that aren't really optimally handled by a wiki: most notably the "FAQ" section should preferably be implemented via some sort of dynamic FAQ system (i.e. http://www.phpmyfaq.de), likewise the sections titled "Bugs", "TODO", "Feature Requests", "ideas" etc. could probably all be handled far more effectively by using a real bug tracker such as bugzilla (http://www.bugzilla.org/), phpbugtracker (http://phpbt.sourceforge.net/) or mantis (http://www.mantisbt.org). | Also, I feel there are some sections covered in the wiki that aren't really optimally handled by a wiki: most notably the "FAQ" section should preferably be implemented via some sort of dynamic FAQ system (i.e. http://www.phpmyfaq.de), likewise the sections titled "Bugs", "TODO", "Feature Requests", "ideas" etc. could probably all be handled far more effectively by using a real bug tracker such as bugzilla (http://www.bugzilla.org/), phpbugtracker (http://phpbt.sourceforge.net/) or mantis (http://www.mantisbt.org). | ||
== Using a dedicated bug tracker == | == Using a dedicated bug tracker == | ||
A couple of days ago I started setting up a local test bugZilla installation, while I am currently unable to provide reliable hosting, I would really not mind installing it on whatever webspace is available, likewise I can provide the preconfigured database dump if someone else wants to use the preconfigured Flightgear specific categories.--[[User:FlightZilla|FlightZilla]] 17:59, 17 June 2006 (EDT) | A couple of days ago I started setting up a local test bugZilla installation, while I am currently unable to provide reliable hosting, I would really not mind installing it on whatever webspace is available, likewise I can provide the preconfigured database dump if someone else wants to use the preconfigured Flightgear specific categories.--[[User:FlightZilla|FlightZilla]] 17:59, 17 June 2006 (EDT) | ||
* how to define and limit editing rights for certain users? | * how to define and limit editing rights for certain users? | ||
Line 52: | Line 20: | ||
Unfortunately, it seems to me, this wiki is not popular among developers and users. -- [[User:Alfozavr|Alfozavr]] 06:59, 17 June 2007 (EDT) | Unfortunately, it seems to me, this wiki is not popular among developers and users. -- [[User:Alfozavr|Alfozavr]] 06:59, 17 June 2007 (EDT) | ||
= | == Backups == | ||
Is the database regularly backed up? What about hosting the wiki directly at flightgear.org? | Is the database regularly backed up? What about hosting the wiki directly at flightgear.org? | ||
--[[User:MILSTD|MILSTD]] 15:25, 4 February 2008 (EST) | --[[User:MILSTD|MILSTD]] 15:25, 4 February 2008 (EST) | ||
Yes, there are daily backups of the [http://hellosimon.org/backups code] and of the [http://hellosimon.org/backups/mysql database]. We also have off-site backups | Yes, there are daily backups of the [http://hellosimon.org/backups code] and of the [http://hellosimon.org/backups/mysql database]. We also have off-site backups. [[User:Hellosimon|Hellosimon]] 17:04, 4 February 2008 (EST) | ||
---- | ---- | ||
== Updates == | |||
I've updated MediaWiki to 1.11.1 so if you notice any regressions let me know. [[User:Hellosimon|Hellosimon]] 15:03, 2 March 2008 (EST) | |||
The | The wiki has moved to a new server which should relieve the performance problems. [[User:Hellosimon|Hellosimon]] 11:26, 10 June 2008 (EDT) | ||
= | === Regressions === | ||
* code passages (i.e. XML) are not highlighted anymore | |||
=== Proposed Additions === | |||
* what about some sort of true syntax-highlighting module, that would properly highlight XML & C++ ? | |||
* PDF Export - [http://sourceforge.net/projects/wikipdf/ Wikimedia plugin to export to PDF] | |||
Regarding the manual: isn't there a possibility to export wikimedia pages to PDF format? That way, we could maintain the whole manual via this wiki. Any thoughts?--[[User:FlightZilla|FlightZilla]] 18:10, 17 June 2006 (EDT) | |||
If you check out the following links, you'll see that there are extensions available that would make it possible to easily provide PDF exports for all contents stored here, that way it would also become feasible to consider migrating the entire manual over to this wiki, so that it would also become more maintainble in the end: | |||
http://meta.wikimedia.org/wiki/WikiPDF | |||
http://meta.wikimedia.org/wiki/PDF_Export | |||
--[[User:FlightZilla|FlightZilla]] 17:21, 19 June 2006 (EDT) | |||
Hello, guys. If I get it right, you're discussing various documentation types here. | |||
I think, this wiki is a lot more convenient than any other form of keeping documentation and at the same time communicating. It can be edited fast and easily and maintained up-to-date. However, the following questions need be solved: | |||
* how to convert it to an offline version (maybe .pdf) so that it could be bundled with the FlightGear base package? |
Revision as of 15:26, 10 June 2008
Making the manual accessible via wiki software
On the other hand, I would recommend to also look into making "The Manual" editable via some sort of web based frontend, this would also ensure that people are able to easily contribute modifications to the manual, which is really the ultimate source for flightgear users. A possible approach might be to import the underlying LaTex sources in docbook format into some sort of docbook based wiki (i.e. http://sourceforge.net/projects/doc-book/).
As the manual is maintained in LaTex, is would be very hard to translate the wiki notes to include them in the manual. I suspect that this will be a "Won't Fix" as it is easier to copy and paste the text from the wiki and go from there. I am open to ideas though. Gorilla 06:33, 2 March 2008 (EST)
Using a dedicated FAQ database
Also, I feel there are some sections covered in the wiki that aren't really optimally handled by a wiki: most notably the "FAQ" section should preferably be implemented via some sort of dynamic FAQ system (i.e. http://www.phpmyfaq.de), likewise the sections titled "Bugs", "TODO", "Feature Requests", "ideas" etc. could probably all be handled far more effectively by using a real bug tracker such as bugzilla (http://www.bugzilla.org/), phpbugtracker (http://phpbt.sourceforge.net/) or mantis (http://www.mantisbt.org).
Using a dedicated bug tracker
A couple of days ago I started setting up a local test bugZilla installation, while I am currently unable to provide reliable hosting, I would really not mind installing it on whatever webspace is available, likewise I can provide the preconfigured database dump if someone else wants to use the preconfigured Flightgear specific categories.--FlightZilla 17:59, 17 June 2006 (EDT)
- how to define and limit editing rights for certain users?
It's better to have one consolidated source of information for both bugs and descriptions. For now, user has to search through mailing lists, forums, user manuals (even not a single user manual, but several) and this wiki. It's absolutely not convinient for both users (they spend lot's of time searching required information) and developers (they spend lot's of time updating and syncronizing certain information in various sources).
This wiki is suitable for bug tracking too. Users can provide feedback in a convinient form. They just open the corresponding page and add their bug to the list. Developers can respond to the posted bugs right away. Mailing lists are a lot less user-friendly and effective and a lot less popular among users (not developers) in this regard, this is the reason why some bugs may stay unreported and why many users forget about FlightGear as soon as they run into a problem.
Unfortunately, it seems to me, this wiki is not popular among developers and users. -- Alfozavr 06:59, 17 June 2007 (EDT)
Backups
Is the database regularly backed up? What about hosting the wiki directly at flightgear.org? --MILSTD 15:25, 4 February 2008 (EST)
Yes, there are daily backups of the code and of the database. We also have off-site backups. Hellosimon 17:04, 4 February 2008 (EST)
Updates
I've updated MediaWiki to 1.11.1 so if you notice any regressions let me know. Hellosimon 15:03, 2 March 2008 (EST)
The wiki has moved to a new server which should relieve the performance problems. Hellosimon 11:26, 10 June 2008 (EDT)
Regressions
- code passages (i.e. XML) are not highlighted anymore
Proposed Additions
- what about some sort of true syntax-highlighting module, that would properly highlight XML & C++ ?
- PDF Export - Wikimedia plugin to export to PDF
Regarding the manual: isn't there a possibility to export wikimedia pages to PDF format? That way, we could maintain the whole manual via this wiki. Any thoughts?--FlightZilla 18:10, 17 June 2006 (EDT)
If you check out the following links, you'll see that there are extensions available that would make it possible to easily provide PDF exports for all contents stored here, that way it would also become feasible to consider migrating the entire manual over to this wiki, so that it would also become more maintainble in the end: http://meta.wikimedia.org/wiki/WikiPDF http://meta.wikimedia.org/wiki/PDF_Export --FlightZilla 17:21, 19 June 2006 (EDT)
Hello, guys. If I get it right, you're discussing various documentation types here.
I think, this wiki is a lot more convenient than any other form of keeping documentation and at the same time communicating. It can be edited fast and easily and maintained up-to-date. However, the following questions need be solved:
- how to convert it to an offline version (maybe .pdf) so that it could be bundled with the FlightGear base package?