Wiki Issues

From Openmoko

(Difference between revisions)
Jump to: navigation, search
m (warning about nameless proposals/comments.)
(gsmd)
 
(179 intermediate revisions by 13 users not shown)
Line 1: Line 1:
If you think something is wrong with a Wiki page, please fix it. If the problem is larger with this Wiki in general, please add your thoughts on this page and mail the openmoko [https://lists.openmoko.org/mailman/listinfo/documentation| documentation mailing list]. You may just want to read existing proposals and put your vote on them, [[Wiki Maintainers]] will appreciate. [[Wiki maintain agenda]].
+
If you think something is wrong with a Wiki page, please fix it. If the problem is larger with this Wiki in general, please add your thoughts on this page and mail the openmoko [http://lists.openmoko.org/mailman/listinfo/documentation documentation mailing list]. You may just want to read existing proposals and put your vote on them, [[Wiki Maintainers]] will appreciate.  
  
When adding an issue please  
+
When adding an issue please
  
 
* Provide a reason
 
* Provide a reason
* Provide your name as vote for the action to be taken (you can automatically enter your username by typing "<nowiki>~~~</nowiki>")
+
* Provide your name as vote for the action to be taken (you can automatically enter your username by typing "
 +
<nowiki>~~~</nowiki> ")
  
 
{{Warning|Comments without name might be deleted without consideration. We may need to ask for more information before implementing a proposal. Thanks for understanding.}}
 
{{Warning|Comments without name might be deleted without consideration. We may need to ask for more information before implementing a proposal. Thanks for understanding.}}
Line 11: Line 12:
  
 
==Wiki Pages==
 
==Wiki Pages==
 +
 +
I think that we should use specific "editor's notes templates" rather that nominate individual pages here. We can make automatic list of pages using a given template by having a Category:X tag inside the template. See for example the [[:Category:ToDo]] . [[User:MinhHaDuong|MinhHaDuong]] 09:44, 7 October 2008 (UTC)
 +
 
===Pages capable of development===
 
===Pages capable of development===
* [[Openmoko:Community Portal]]
+
* [[Community Resources]]
* [[Documentation]]
+
* [[AGPSD]] (Needs new GPS info)
+
 
* [[AR6K]] (Needs more info)
 
* [[AR6K]] (Needs more info)
 
* [[GTA02 partitions]]: seems to be about the GTA01; could someone with a GTA02 please correct the partition sizes and names?
 
* [[GTA02 partitions]]: seems to be about the GTA01; could someone with a GTA02 please correct the partition sizes and names?
 +
* [[Advanced_End-user]], [[Basic_End-user]], [[System_Developer]]: These are not up to the standard we set for List Pages on [[Openmoko_Wiki_Editing_Guidelines#List_pages]] [[User:Kempelen|Kempelen]]
  
 
===Redundant Pages===
 
===Redundant Pages===
Line 25: Line 28:
 
*** [[Carriers/Fido]]
 
*** [[Carriers/Fido]]
 
*** [[Carriers/Rogers]]
 
*** [[Carriers/Rogers]]
** [[Openmoko compatible cellphone providers]]
 
 
** [[Neo1973 compatible cellphone providers]]
 
** [[Neo1973 compatible cellphone providers]]
  
Line 39: Line 41:
  
 
*applications:
 
*applications:
**[[Available Packages]]
 
 
**[[Applications]]
 
**[[Applications]]
 +
**[[Om 2007.2 Applications]]
  
 
===Tidy up===
 
===Tidy up===
Line 48: Line 50:
 
=== Pages proposed for deletion ===
 
=== Pages proposed for deletion ===
  
{| border=1 cellspacing=0
+
This is a place for proposing pages of this wiki for deletion and discussing the proposal. See [[Openmoko Wiki Editing Guidelines#Deleting pages]] for details. Old discussions are archived to [[Wiki Issues/archive]].
!Page
+
!Reason
+
!Yes votes
+
!No votes
+
|-
+
| [[ChangeLog]] || Outdated || [[User:Kempelen|Kempelen]], [[User:Marko Knöbl|Marko Knöbl]] || [[User:Dolfje]]: I've changed it
+
|-
+
| [[Neo1973_AUX_Button]] || Getting started includes this info for GTA02 || [[User:Kempelen|Kempelen]], [[User:Marko Knöbl|Marko Knöbl]]
+
|-
+
| [[Neo_1973_Power_Button]] || Getting started includes this info for GTA02 || [[User:Kempelen|Kempelen]], [[User:Marko Knöbl|Marko Knöbl]]
+
|-
+
| [[Roadmap]] || Emtpy bascially || [[User:Kempelen|Kempelen]], [[User:Marko Knöbl|Marko Knöbl]]
+
|-
+
|[[Why Not QT]] and [[Talk:Why Not QT]] || outdated || [[User:Marko Knöbl|Marko Knöbl]], [[User:Kempelen|Kempelen]]
+
|-
+
|[[Application]] || outdated || [[User:Marko Knöbl|Marko Knöbl]], [[User:Kempelen|Kempelen]]
+
|-
+
|[[Community Member of the Week]] || not used anymore since April || [[User:Marko Knöbl|Marko Knöbl]], [[User:Kempelen|Kempelen]]
+
|-
+
|[[Community nominees for GTA02 P0]] || outdated, not needed anymore || [[User:Marko Knöbl|Marko Knöbl]], [[User:Kempelen|Kempelen]]
+
|-
+
|[[Config Options]] || little content, not maintained || [[User:Marko Knöbl|Marko Knöbl]], [[User:Kempelen|Kempelen]]
+
|-
+
|[[Neo 1973 Phase 1]] || outdated, unfinished page || [[User:Marko Knöbl|Marko Knöbl]], [[User:Kempelen|Kempelen]]
+
|-
+
|[[Developer preview]] || outdated || [[User:Marko Knöbl|Marko Knöbl]], [[User:Kempelen|Kempelen]]
+
|-
+
|[[ETel]] and [[Talk:ETel]] || is about a past event || [[User:Marko Knöbl|Marko Knöbl]] || [[User:Kempelen|Kempelen]] (moved to Event category that's for past events too)
+
|-
+
|[[Finger Scrolling]] and [[Talk:Finger Scrolling]] || Was only used in Om 2007.2 || [[User:Marko Knöbl|Marko Knöbl]]
+
|-
+
|[[Finger Toolbar]] and [[Talk:Finger Toolbar]] || Was only used in Om 2007.2 || [[User:Marko Knöbl|Marko Knöbl]]
+
|-
+
|[[GPS Navigation]] and [[Talk:GPS Navigation]] || is already implemented: see [[GPS Applications]] || [[User:Marko Knöbl|Marko Knöbl]] || [[User:Kempelen|Kempelen]] Need to merge use cases first.
+
|-
+
|[[GTA02v5]] || only contains links to deleted pages || [[User:Marko Knöbl|Marko Knöbl]], [[User:Kempelen|Kempelen]]
+
|-
+
|[[Guitar Tuning/de]] || english page was already deleted || [[User:Marko Knöbl|Marko Knöbl]]
+
|-
+
|[[Hear Me FIC]], [[Talk:Hear Me FIC]] and [[Hear Me FIC/it]] || no new suggestions since July 2007 || [[User:Marko Knöbl|Marko Knöbl]], [[User:Kempelen|Kempelen]]
+
|}
+
  
=== Pages that especially need work ===  
+
==== [[gsmd]] ====
 +
 
 +
Outdated (according to Mickey), not updated for over a year --[[User:Marko Knöbl|Marko Knöbl]]
 +
:I vote "'''yes'''", if it is for sure, not used anymore.How can we check it?-[[User:Leadman|LeadMan]]
 +
:I vote "'''no'''". I'm really new to the OpenMoko world and I've found that page really interest in understanding how the gsm work at low level. It has help me to understand a lot how freesmartphone.org works. [[User:Risca|Risca]]
 +
:I vote "'''no'''". I'm trying to write my own implementation, and would love to learn from what is already written. [[User:kapiteined|Ed Kapitein]]
 +
 
 +
==== [[Group sales]] ====
 +
 
 +
This page is not used anymore: the last time someone entered his name to the list was 1 January 2010. --[[User:Marko Knöbl|Marko Knöbl]] 17:37, 10 August 2010 (UTC)
 +
 
 +
=== Pages that especially need work ===
  
* [[:Category:Candidates for speedy deletion]]
 
 
* [[Special:Lonelypages]] - Orphaned pages
 
* [[Special:Lonelypages]] - Orphaned pages
 
* [[Special:DoubleRedirects]] - Pages that redirect to a redirected page
 
* [[Special:DoubleRedirects]] - Pages that redirect to a redirected page
Line 104: Line 75:
 
* [[Special:BrokenRedirects]] - Broken redirects
 
* [[Special:BrokenRedirects]] - Broken redirects
  
==Categories ==
+
=== Application pages ===
  
===General issues with categories===
+
Maturity level ideas from the documentation list copied by [[User:Kempelen|Kempelen]] 19:05, 1 October 2008 (UTC):
* Please read wikipedia [http://en.wikipedia.org/wiki/Wikipedia:Categorization Categorization] page and [http://en.wikipedia.org/wiki/Wikipedia:FAQ/Categorization FAQ]
+
* There are way too many [[Special:Categories| categories]].
+
* The [http://wiki.openmoko.org/wiki/Openmoko_Wiki_Categories_Index_Page categories index] is static and therefore out of date.
+
* The [http://wiki.openmoko.org/wiki/Openmoko_Wiki_Official_Index_Page wiki index] is another static categorization. It is therefore out of date. Moreover, it seems strictly hierarchical, while actually pages should be described with multiple categories, and categories can have multiple parents.
+
* There should be a small number of a orthogonal category trees, each describing one consistent conceptual taxonomy.
+
* Ideally categories should not include language, if we don't do so the list of pages is cluttered.
+
* There should be only one category taxonomy for the "Neo type" with subcategories "FreeRunner", "Neo1973", "GTA03"... Otherwise, categories should not include the Neo type.
+
* Another big taxonomy can be based on the layers model. "Hardware", "Drivers", "Operating system", "Framework", "Applications", "Distributions". With many subcategories here.
+
* A taxonomy of technical level of expertise "General public", "Beginners", "Users", "Experts".
+
* A taxonomy by function or by subsystem: "Phone", "Wifi", "GPS/GPRS modem", "USB", "Bluetooth", "Accelerometers", "Audio", "Power", "SD card", "Serial bus", "Display", "Accessories", "Debug board"
+
* A taxonomy by maturity: "Wishlist", "Experimental", "Unstable", "Testing", "Stable".
+
[[User:MinhHaDuong|MinhHaDuong]] 10:47, 24 August 2008 (UTC)
+
  
===Lists now implemented as categories===
+
* It might be nice to have a single word stating the code maturity, perhaps only 3 simple options like prototype, functional, mature
 +
* Why not stick with pre-alpha, alpha, beta, stable, mature
  
These Pages are now implemented as categories, thus the unmaintaned pages could be removed. - Kempelen
+
Decision postponed. :-) (Feel free to vote here anyway.)
  
{| border=1
+
== Categories ==
!List to remove
+
!Category to use
+
!Yes votes
+
!No votes
+
|-
+
| [[Advanced_End-user]] || [[:Category:Advanced End User]] || [[User:Kempelen|Kempelen]]
+
|-
+
| [[Basic_End-user]]|| [[:Category:Basic End User]] || [[User:Kempelen|Kempelen]]
+
|-
+
| [[System_Developer]] || [[:Category:System_Developers]] || [[User:Kempelen|Kempelen]]
+
|-
+
| [[Application_Developer]] || [[:Category:Application_Developer]] || [[User:Kempelen|Kempelen]]
+
|-
+
|}
+
  
Note that as a matter of principle, lists and categories are two complementary ways to organize information. We should strive to have both excellent lists AND categories in the wiki.
+
{{Main|:Category talk:Categories}}
  
===Too general category names===
+
== CSS ==
  
These end up in mixed content. They could be removed and content migrated to more specific category names.
+
We have discussed design on the mailing list, with the conclusion that revising was not a big priority. However, the wiki should be skinnable from user-space by editing : http://wiki.openmoko.org/wiki/MediaWiki:Common.css . And for development, each user can have his/her own CSS to eat his own dogfood. But I can't seem to make this feature work here.
 +
Reference: http://en.wikipedia.org/wiki/Help:Monobook
 +
[[User:MinhHaDuong|MinhHaDuong]] 12:26, 12 September 2008 (UTC).
  
{| border="1"
+
* The gutter is too wide
!Category to delete
+
* Too much footer's padding
!Yes votes
+
* Could shave 1 or 2 em of vertical space in the header
!No votes
+
* The tabbed navigation layout is non-standard (no framing effect)
|-
+
* The search box is below the fold (depends on window height of course)
|[[:Category:Documentation]] || [[User:Kempelen|Kempelen]], [[User:Marko Knöbl|Marko Knöbl]]
+
* The toolbox (bottom left) has no border
|-
+
* Mediawiki's user personal toolbox is prohibited
| [[:Category:Information]] || [[User:Kempelen|Kempelen]], [[User:Marko Knöbl|Marko Knöbl]]
+
* Too many links in the navbar that belongs to the home page but not to every page
|-
+
| [[:Category:Openmoko]](1) || [[User:Kempelen|Kempelen]], [[User:Marko Knöbl|Marko Knöbl]]
+
|-
+
| [[:Category:Technical]]  || [[User:Kempelen|Kempelen]], [[User:Marko Knöbl|Marko Knöbl]]
+
|}
+
  
(1) We've moved Openmoko Inc related info from Openmoko to a new Openmoko Inc category. This was the original aim of the Openmoko category when it was created.
+
== Portals ==
  
===The Category:ideas===
+
We should explore another wiki organization tool: [http://en.wikipedia.org/wiki/Portal:Contents/Portals portals]. A portal is an introductory page for a given topic. It complements the main article of the subject by introducing the reader to key articles, images, and categories that further describe the subject. Portals also help editors find related projects and things they can do to help. [[User:MinhHaDuong|MinhHaDuong]] 13:53, 20 September 2008 (UTC)
Problem 1:
+
Many pages have  Wishlist:   in the title. This syntax is potentially confusing because there is no Wishlist:  namespace. Should we suggest a mass rename from "Wishlist:(.*)" to "Ideas - \1" ? Or really create a  Wishlist:  namespace for vaporware ?
+
 
+
Problem 2:
+
A significant minority of pages in the "Category:ideas" are missing the prefix in the title.
+
 
+
Problem 3:
+
There are two templates, { { Wishlist } } and { { Unimplemented } } . Is that unnecessary redundancy, or is there a subtle distinction .
+
 
+
=== Category structure ===
+
 
+
{{Editing|Kempelen|2008/08/29|Discovering category structure}}
+
 
+
Names are votes. See also: Too general category names above.
+
 
+
Top level categories.
+
 
+
* [[:Category:Categories]] - container for top level categories.
+
** [[:Category:Community]]
+
** [[:Category:Documentation]] (Remove: [[User:Kempelen|Kempelen]])
+
** [[:Category:Hardware]]
+
** [[:Category:Information]] - (Remove: [[User:Kempelen|Kempelen]])
+
** [[:Category:Openmoko]] - (Remove: [[User:Kempelen|Kempelen]])
+
** [[:Category:Policy]] - Developer policies (OK: [[User:Kempelen|Kempelen]])
+
** [[:Category:Software]] - (OK: [[User:Kempelen|Kempelen]])
+
** [[:Category:Technical]] - (Remove: [[User:Kempelen|Kempelen]])
+
** [[:Category:ToDo]] - The TODO template adds here (OK: [[User:Kempelen|Kempelen]])
+
** [[:Category:User's Manual]] -
+
 
+
Subcategories of Software. Looks well designed:
+
 
+
* [[:Category:Software]] - Articles should not be added here directly.
+
** [[:Category:Applications]] - (OK: [[User:Kempelen|Kempelen]])
+
** [[:Category:Distributions]] - (OK: [[User:Kempelen|Kempelen]])
+
** [[:Category:Software (non openmoko)]] - (OK: [[User:Kempelen|Kempelen]])
+
 
+
Applications category contains subcategories for various application groups, like GPS, Networking... This may be a problem if e.g. GPS belongs to Applications and Hardware too (and most of these stuff will belong to both). Maybe we could simply add articles to Applications AND GPS, which won't be subcategories of each other. [[User:Kempelen|Kempelen]] 20:54, 29 August 2008 (UTC)
+
 
+
Basic End User and Advanced End User categories may need to be created instead User, which is not enough specific term. [[User:Kempelen|Kempelen]]
+
  
 
== Navigation templates ==
 
== Navigation templates ==
  
Exemples: [[Template:Om_2008.8]], [[Template:OM2007.2]]
+
(FYI Description moved to [[Openmoko_Wiki_Editing_Guidelines#Navigation_templates]], [[User:Kempelen|Kempelen]])
  
These are most useful to present small sets of chronological or otherwise
 
well ordered information items. For example, it's obvious to offer navigation
 
templates between these articles:
 
* Openmoko produced smartphones {GTA01 Neo 1973, GTA02 Neo FreeRunner, GTA 03
 
(speculative)}
 
* Distributions {2007.1, 2007.2, 2008.8 ASU, 2008.9, FSO, SHR, Qtopia, Debian}
 
 
In effect navigation templates create a subset of important pages presented sequentially. This corresponds more or less to a chapter in the user manual. We should not force them where they cannot create a CONSISTENT  forth-and-back navigation between a GROUP OF PAGES.
 
 
=== Issues ===
 
 
* The [[Distributions]] page feature a non-templated navigation box
 
* The [[Distributions]] page feature a non-templated navigation box
 
* We should name these templates distinctly. I suggest using a prefix like "NavBox:".
 
* We should name these templates distinctly. I suggest using a prefix like "NavBox:".
Line 222: Line 116:
 
* Need to test positioning at bottom of article.
 
* Need to test positioning at bottom of article.
  
=== References ===
+
'''References'''
 +
 
 
http://en.wikipedia.org/wiki/Wikipedia:Navigation_templates
 
http://en.wikipedia.org/wiki/Wikipedia:Navigation_templates
 
http://en.wikipedia.org/wiki/Wikipedia:Categories,_lists,_and_series_boxes
 
http://en.wikipedia.org/wiki/Wikipedia:Categories,_lists,_and_series_boxes
  
 
[http://lists.openmoko.org/pipermail/documentation/2008-August/000405.html First discussion in the mailing list] (Note: in the middle of a thread about left navboxes)
 
[http://lists.openmoko.org/pipermail/documentation/2008-August/000405.html First discussion in the mailing list] (Note: in the middle of a thread about left navboxes)
 +
 +
* '''Yes votes''': [[User:Kempelen|Kempelen]] (For real wikipedia like navigation templates at the bottom, not at TOC position, we should move this section to editing guidelines as soon as template implementation improves a bit. Do not delete this please!)
  
 
== DolfjeBot1 proposals ==
 
== DolfjeBot1 proposals ==
 
Their is a bot on the openmoko wiki that's controlled by [[User:Dolfje]]. If you have tasks for the bot, please put them [[User:DolfjeBot1|here]].
 
Their is a bot on the openmoko wiki that's controlled by [[User:Dolfje]]. If you have tasks for the bot, please put them [[User:DolfjeBot1|here]].
 +
A request has been made to tag DolfjeBot1 user account with the 'bot' flag. [[Special:Listusers/bureaucrat| Here is the lists of users]] with permissions at the necessary `bureaucrat' level.
 +
 +
== Wiki engine issues ==
  
==Wiki engine issues==
 
 
Can we please install/fix the following features for this wiki:
 
Can we please install/fix the following features for this wiki:
 
* '''Math''' - the Tex math markup does not work currently. Test:
 
* '''Math''' - the Tex math markup does not work currently. Test:
Line 237: Line 136:
 
** <math> P_{ind} </math>
 
** <math> P_{ind} </math>
 
* [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi '''Syntax''' Highlighting - makes code much more readable]
 
* [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi '''Syntax''' Highlighting - makes code much more readable]
 +
: Report to Openmoko IT on 26,Dec 2008. You can check https://admin-trac.openmoko.org/trac/ticket/1695 for detail.
 
* [http://www.mediawiki.org/wiki/Extension:GraphViz GraphViz] works with the commonly known dot language - it allows us to draw '''graphs''' using easy markup.
 
* [http://www.mediawiki.org/wiki/Extension:GraphViz GraphViz] works with the commonly known dot language - it allows us to draw '''graphs''' using easy markup.
 
* [http://www.mediawiki.org/wiki/Extension:AnyWikiDraw AnyWikiDraw] allows us to draw svg '''diagrams''' directly on the wiki page.
 
* [http://www.mediawiki.org/wiki/Extension:AnyWikiDraw AnyWikiDraw] allows us to draw svg '''diagrams''' directly on the wiki page.
 
* Make '''visited links''' a different color.
 
* Make '''visited links''' a different color.
 +
** Sysop should edit [[MediaWiki:Common.css|this page]]
 +
* Updating MediaWiki to [http://download.wikimedia.org/mediawiki/1.15/mediawiki-1.15.1.tar.gz v. 15.1]
 +
* Adding some extensions: [http://www.mediawiki.org/wiki/Extension:Cite/Cite.php Cite], [http://www.mediawiki.org/wiki/Extension:ParserFunctions Parser function] (!), [http://www.mediawiki.org/wiki/Extension:Poem Poem tag] and [http://www.mediawiki.org/wiki/Extension:CentralNotice Central Notice] --<small style="background:#f00">'''[[User:Airon90|<span style="color:#000">→ A</span>]][[Special:Contributions/Airon90|<span style="color:#f00;background:#000">ir</span>]][[User talk:Airon90|<span style="color:#000">on</span>]]'''</small> 21:19, 22 February 2010 (UTC)
  
 
== Change Sitename ==
 
== Change Sitename ==
Line 246: Line 149:
  
 
* The other parts of this site (Planet, Projects, Docs) have similar names
 
* The other parts of this site (Planet, Projects, Docs) have similar names
* Media Wiki automatically creates a [http://www.mediawiki.org/wiki/Manual:Namespace namespace] for the Sitename (currently "Openmoko"). This means that content of pages beginning with "Openmoko:" cannot be found through the normal search function of this wiki. (At the moment there are six pages of this kind: [[Openmoko:About]], [[Openmoko:Community Portal]], [[Openmoko:Current events]], [[Openmoko:Searching]], [[Openmoko:Current events/it]], [[Openmoko:Privacy policy]])--[[User:Marko Knöbl|Marko Knöbl]] 18:33, 8 August 2008 (UTC)
+
* Media Wiki automatically creates a [http://www.mediawiki.org/wiki/Manual:Namespace namespace] for the Sitename (currently "Openmoko"). This means that content of pages beginning with "Openmoko:" cannot be found through the normal search function of this wiki. (At the moment there are four pages of this kind: [[Openmoko:About]], [[Openmoko:Current events]], [[Openmoko:Searching]], [[Openmoko:Privacy policy]])--[[User:Marko Knöbl|Marko Knöbl]] 18:33, 8 August 2008 (UTC)
  
 
'''Yes votes''': [[User:Marko Knöbl|Marko Knöbl]], [[User:MinhHaDuong|Minh]]
 
'''Yes votes''': [[User:Marko Knöbl|Marko Knöbl]], [[User:MinhHaDuong|Minh]]
  
 
'''No votes''':
 
'''No votes''':
 +
 +
::OpenmokoIT still do some research now. [[User:Coolcat|coolcat]]
 +
 +
::Then fix the search function (by restoring the standard MediaWiki search function). Anyway they are [[Special:Allpages/Openmoko:]]. Anyway, any links like [[Special:Allpages/Openmoko:]] will break, unless you use [[Special:Allpages/Project:]]. Furthermore, the longer the name of the Project ($wgSitename) becomes, the longer the UTF-8 translations of it will become, and as e.g., for Chinese UTF-8 at 3*3=9 ASCII %XX%XX%XX per character, you'll end up with mile long URLs before long, that is if one day the site becomes fully translated. [[User:Jidanni|Jidanni]] 01:04, 22 November 2008 (UTC)
  
 
== Organize translations ==
 
== Organize translations ==
Line 256: Line 163:
 
I suggest moving the translations to sub-wikis, like the way wikipedia does it. Currently all translations show up in searches and under category-lists. --[[User:Johndoesacc|Johndoesacc]] 12:03, 25 August 2008 (UTC)
 
I suggest moving the translations to sub-wikis, like the way wikipedia does it. Currently all translations show up in searches and under category-lists. --[[User:Johndoesacc|Johndoesacc]] 12:03, 25 August 2008 (UTC)
  
 +
+1. See issues and solutions for a multilingual mediawiki at:
 +
http://www.mediawiki.org/wiki/Multilingual_MediaWiki
 +
Also, the correspondence between translation should be maintained with tags:
 +
http://en.wikipedia.org/wiki/Help:Interlanguage_links
 +
The request [http://lists.openmoko.org/pipermail/documentation/2008-September/000557.html has been heard] but maybe not in the right places. What is the best operational frequency to ping the hosting engineers for that ? [[User:MinhHaDuong|MinhHaDuong]] 13:02, 10 September 2008 (UTC)
 +
 +
After discussion on the Documentation ML, sub-wikis are out. We want to try namespaces. [[User:MinhHaDuong|MinhHaDuong]] 09:31, 7 October 2008 (UTC)
 +
 +
== Downloads ==
 +
 +
=== Symlinks in download directories ===
 +
 +
This is not strictly Wiki issue, but discussed on the documentation list as being a serious usability disadvantage. Symlinks and .tar.gz files should be removed from the release directories because they confuse users. Ref: [http://lists.openmoko.org/pipermail/documentation/2008-September/000808.html]
 +
 +
=== Improve README.html ===
 +
 +
Example: http://downloads.openmoko.org/distro/releases/Om2008.9/README.html
 +
 +
It should at least link to: [[Om_2008.9_Update#Download_and_Flashing]]
  
 
== Rejected requests ==
 
== Rejected requests ==
Line 263: Line 189:
 
* '''Don't translate the wiki - rejected''' proposed by [[User:Minime|Minime]] August 2007, moved to rejected by [[User:Kempelen|Kempelen]] August 2008: the Documentation Team looks to support the idea.
 
* '''Don't translate the wiki - rejected''' proposed by [[User:Minime|Minime]] August 2007, moved to rejected by [[User:Kempelen|Kempelen]] August 2008: the Documentation Team looks to support the idea.
 
* '''Use namespaces to separate user-oriented and developper-oriented content'''. Assuming the default namespace is user-oriented that would exclude developper-oriented pages from searches (unless the user ticks the box, but who does ?). And it can't be done purely in the wiki, it needs admin time. Better to use categories and a prefix in the page name (like BlendeWiki). [[:User:MinhHaDuong|MinhHaDuong]]
 
* '''Use namespaces to separate user-oriented and developper-oriented content'''. Assuming the default namespace is user-oriented that would exclude developper-oriented pages from searches (unless the user ticks the box, but who does ?). And it can't be done purely in the wiki, it needs admin time. Better to use categories and a prefix in the page name (like BlendeWiki). [[:User:MinhHaDuong|MinhHaDuong]]
 +
* '''Use category pages instead List Pages''' Good list pages are allowed and encouraged, as the documentation team today agreed on the mailing list. [[User:Kempelen|Kempelen]] 21:27, 30 August 2008 (UTC)
  
 
[[Category:Wiki Editing]]
 
[[Category:Wiki Editing]]

Latest revision as of 10:42, 5 October 2011

If you think something is wrong with a Wiki page, please fix it. If the problem is larger with this Wiki in general, please add your thoughts on this page and mail the openmoko documentation mailing list. You may just want to read existing proposals and put your vote on them, Wiki Maintainers will appreciate.

When adding an issue please

  • Provide a reason
  • Provide your name as vote for the action to be taken (you can automatically enter your username by typing "

~~~ ")

WARNING: Comments without name might be deleted without consideration. We may need to ask for more information before implementing a proposal. Thanks for understanding.


Accepted and implemented requests should be deleted. Rejected requests should be moved to the bottom of the page to avoid requesting them again.

Contents

[edit] Wiki Pages

I think that we should use specific "editor's notes templates" rather that nominate individual pages here. We can make automatic list of pages using a given template by having a Category:X tag inside the template. See for example the Category:ToDo . MinhHaDuong 09:44, 7 October 2008 (UTC)

[edit] Pages capable of development

[edit] Redundant Pages

[edit] Tidy up

[edit] Pages proposed for deletion

This is a place for proposing pages of this wiki for deletion and discussing the proposal. See Openmoko Wiki Editing Guidelines#Deleting pages for details. Old discussions are archived to Wiki Issues/archive.

[edit] gsmd

Outdated (according to Mickey), not updated for over a year --Marko Knöbl

I vote "yes", if it is for sure, not used anymore.How can we check it?-LeadMan
I vote "no". I'm really new to the OpenMoko world and I've found that page really interest in understanding how the gsm work at low level. It has help me to understand a lot how freesmartphone.org works. Risca
I vote "no". I'm trying to write my own implementation, and would love to learn from what is already written. Ed Kapitein

[edit] Group sales

This page is not used anymore: the last time someone entered his name to the list was 1 January 2010. --Marko Knöbl 17:37, 10 August 2010 (UTC)

[edit] Pages that especially need work

[edit] Application pages

Maturity level ideas from the documentation list copied by Kempelen 19:05, 1 October 2008 (UTC):

  • It might be nice to have a single word stating the code maturity, perhaps only 3 simple options like prototype, functional, mature
  • Why not stick with pre-alpha, alpha, beta, stable, mature

Decision postponed. :-) (Feel free to vote here anyway.)

[edit] Categories

Main article: Category talk:Categories


[edit] CSS

We have discussed design on the mailing list, with the conclusion that revising was not a big priority. However, the wiki should be skinnable from user-space by editing : http://wiki.openmoko.org/wiki/MediaWiki:Common.css . And for development, each user can have his/her own CSS to eat his own dogfood. But I can't seem to make this feature work here. Reference: http://en.wikipedia.org/wiki/Help:Monobook MinhHaDuong 12:26, 12 September 2008 (UTC).

  • The gutter is too wide
  • Too much footer's padding
  • Could shave 1 or 2 em of vertical space in the header
  • The tabbed navigation layout is non-standard (no framing effect)
  • The search box is below the fold (depends on window height of course)
  • The toolbox (bottom left) has no border
  • Mediawiki's user personal toolbox is prohibited
  • Too many links in the navbar that belongs to the home page but not to every page

[edit] Portals

We should explore another wiki organization tool: portals. A portal is an introductory page for a given topic. It complements the main article of the subject by introducing the reader to key articles, images, and categories that further describe the subject. Portals also help editors find related projects and things they can do to help. MinhHaDuong 13:53, 20 September 2008 (UTC)

[edit] Navigation templates

(FYI Description moved to Openmoko_Wiki_Editing_Guidelines#Navigation_templates, Kempelen)

  • The Distributions page feature a non-templated navigation box
  • We should name these templates distinctly. I suggest using a prefix like "NavBox:".
  • Visual design is by hand (not CSS), and not beautiful
  • Need to test positioning at bottom of article.

References

http://en.wikipedia.org/wiki/Wikipedia:Navigation_templates http://en.wikipedia.org/wiki/Wikipedia:Categories,_lists,_and_series_boxes

First discussion in the mailing list (Note: in the middle of a thread about left navboxes)

  • Yes votes: Kempelen (For real wikipedia like navigation templates at the bottom, not at TOC position, we should move this section to editing guidelines as soon as template implementation improves a bit. Do not delete this please!)

[edit] DolfjeBot1 proposals

Their is a bot on the openmoko wiki that's controlled by User:Dolfje. If you have tasks for the bot, please put them here. A request has been made to tag DolfjeBot1 user account with the 'bot' flag. Here is the lists of users with permissions at the necessary `bureaucrat' level.

[edit] Wiki engine issues

Can we please install/fix the following features for this wiki:

Report to Openmoko IT on 26,Dec 2008. You can check https://admin-trac.openmoko.org/trac/ticket/1695 for detail.

[edit] Change Sitename

The name of this wiki is currently "Openmoko". I think it should be "Openmoko Wiki" for the following reasons:

Yes votes: Marko Knöbl, Minh

No votes:

OpenmokoIT still do some research now. coolcat
Then fix the search function (by restoring the standard MediaWiki search function). Anyway they are Special:Allpages/Openmoko:. Anyway, any links like Special:Allpages/Openmoko: will break, unless you use Special:Allpages/Project:. Furthermore, the longer the name of the Project ($wgSitename) becomes, the longer the UTF-8 translations of it will become, and as e.g., for Chinese UTF-8 at 3*3=9 ASCII %XX%XX%XX per character, you'll end up with mile long URLs before long, that is if one day the site becomes fully translated. Jidanni 01:04, 22 November 2008 (UTC)

[edit] Organize translations

I suggest moving the translations to sub-wikis, like the way wikipedia does it. Currently all translations show up in searches and under category-lists. --Johndoesacc 12:03, 25 August 2008 (UTC)

+1. See issues and solutions for a multilingual mediawiki at: http://www.mediawiki.org/wiki/Multilingual_MediaWiki Also, the correspondence between translation should be maintained with tags: http://en.wikipedia.org/wiki/Help:Interlanguage_links The request has been heard but maybe not in the right places. What is the best operational frequency to ping the hosting engineers for that ? MinhHaDuong 13:02, 10 September 2008 (UTC)

After discussion on the Documentation ML, sub-wikis are out. We want to try namespaces. MinhHaDuong 09:31, 7 October 2008 (UTC)

[edit] Downloads

[edit] Symlinks in download directories

This is not strictly Wiki issue, but discussed on the documentation list as being a serious usability disadvantage. Symlinks and .tar.gz files should be removed from the release directories because they confuse users. Ref: [1]

[edit] Improve README.html

Example: http://downloads.openmoko.org/distro/releases/Om2008.9/README.html

It should at least link to: Om_2008.9_Update#Download_and_Flashing

[edit] Rejected requests

When a requested Wiki Issue is voted for not to be done, it must be moved here, to make sure it won't get continously requested again.

  • Don't translate the wiki - rejected proposed by Minime August 2007, moved to rejected by Kempelen August 2008: the Documentation Team looks to support the idea.
  • Use namespaces to separate user-oriented and developper-oriented content. Assuming the default namespace is user-oriented that would exclude developper-oriented pages from searches (unless the user ticks the box, but who does ?). And it can't be done purely in the wiki, it needs admin time. Better to use categories and a prefix in the page name (like BlendeWiki). MinhHaDuong
  • Use category pages instead List Pages Good list pages are allowed and encouraged, as the documentation team today agreed on the mailing list. Kempelen 21:27, 30 August 2008 (UTC)
Personal tools

If you think something is wrong with a Wiki page, please fix it. If the problem is larger with this Wiki in general, please add your thoughts on this page and mail the openmoko documentation mailing list. You may just want to read existing proposals and put your vote on them, Wiki Maintainers will appreciate. Wiki maintain agenda.

When adding an issue please

  • Provide a reason
  • Provide your name as vote for the action to be taken (you can automatically enter your username by typing "~~~")
WARNING: Comments without name might be deleted without consideration. We may need to ask for more information before implementing a proposal. Thanks for understanding.


Accepted and implemented requests should be deleted. Rejected requests should be moved to the bottom of the page to avoid requesting them again.

Wiki Pages

Pages capable of development

Redundant Pages

Tidy up

Pages proposed for deletion

Page Reason Yes votes No votes
ChangeLog Outdated Kempelen, Marko Knöbl User:Dolfje: I've changed it
Neo1973_AUX_Button Getting started includes this info for GTA02 Kempelen, Marko Knöbl
Neo_1973_Power_Button Getting started includes this info for GTA02 Kempelen, Marko Knöbl
Roadmap Emtpy bascially Kempelen, Marko Knöbl
Why Not QT and Talk:Why Not QT outdated Marko Knöbl, Kempelen
Application outdated Marko Knöbl, Kempelen
Community Member of the Week not used anymore since April Marko Knöbl, Kempelen
Community nominees for GTA02 P0 outdated, not needed anymore Marko Knöbl, Kempelen
Config Options little content, not maintained Marko Knöbl, Kempelen
Neo 1973 Phase 1 outdated, unfinished page Marko Knöbl, Kempelen
Developer preview outdated Marko Knöbl, Kempelen
ETel and Talk:ETel is about a past event Marko Knöbl Kempelen (moved to Event category that's for past events too)
Finger Scrolling and Talk:Finger Scrolling Was only used in Om 2007.2 Marko Knöbl
Finger Toolbar and Talk:Finger Toolbar Was only used in Om 2007.2 Marko Knöbl
GPS Navigation and Talk:GPS Navigation is already implemented: see GPS Applications Marko Knöbl Kempelen Need to merge use cases first.
GTA02v5 only contains links to deleted pages Marko Knöbl, Kempelen
Guitar Tuning/de english page was already deleted Marko Knöbl
Hear Me FIC, Talk:Hear Me FIC and Hear Me FIC/it no new suggestions since July 2007 Marko Knöbl, Kempelen

Pages that especially need work

Categories

General issues with categories

  • Please read wikipedia Categorization page and FAQ
  • There are way too many categories.
  • The categories index is static and therefore out of date.
  • The wiki index is another static categorization. It is therefore out of date. Moreover, it seems strictly hierarchical, while actually pages should be described with multiple categories, and categories can have multiple parents.
  • There should be a small number of a orthogonal category trees, each describing one consistent conceptual taxonomy.
  • Ideally categories should not include language, if we don't do so the list of pages is cluttered.
  • There should be only one category taxonomy for the "Neo type" with subcategories "FreeRunner", "Neo1973", "GTA03"... Otherwise, categories should not include the Neo type.
  • Another big taxonomy can be based on the layers model. "Hardware", "Drivers", "Operating system", "Framework", "Applications", "Distributions". With many subcategories here.
  • A taxonomy of technical level of expertise "General public", "Beginners", "Users", "Experts".
  • A taxonomy by function or by subsystem: "Phone", "Wifi", "GPS/GPRS modem", "USB", "Bluetooth", "Accelerometers", "Audio", "Power", "SD card", "Serial bus", "Display", "Accessories", "Debug board"
  • A taxonomy by maturity: "Wishlist", "Experimental", "Unstable", "Testing", "Stable".

MinhHaDuong 10:47, 24 August 2008 (UTC)

Lists now implemented as categories

These Pages are now implemented as categories, thus the unmaintaned pages could be removed. - Kempelen

List to remove Category to use Yes votes No votes
Advanced_End-user Category:Advanced End User Kempelen
Basic_End-user Category:Basic End User Kempelen
System_Developer Category:System_Developers Kempelen
Application_Developer Category:Application_Developer Kempelen

Note that as a matter of principle, lists and categories are two complementary ways to organize information. We should strive to have both excellent lists AND categories in the wiki.

Too general category names

These end up in mixed content. They could be removed and content migrated to more specific category names.

Category to delete Yes votes No votes
Category:Documentation Kempelen, Marko Knöbl
Category:Information Kempelen, Marko Knöbl
Category:Openmoko(1) Kempelen, Marko Knöbl
Category:Technical Kempelen, Marko Knöbl

(1) We've moved Openmoko Inc related info from Openmoko to a new Openmoko Inc category. This was the original aim of the Openmoko category when it was created.

The Category:ideas

Problem 1: Many pages have Wishlist: in the title. This syntax is potentially confusing because there is no Wishlist: namespace. Should we suggest a mass rename from "Wishlist:(.*)" to "Ideas - \1" ? Or really create a Wishlist: namespace for vaporware ?

Problem 2: A significant minority of pages in the "Category:ideas" are missing the prefix in the title.

Problem 3: There are two templates, { { Wishlist } } and { { Unimplemented } } . Is that unnecessary redundancy, or is there a subtle distinction .

Category structure

Editing: (2008/08/29) This page is being edited by Kempelen: Discovering category structure

If this note persists without edits in the history, feel free to remove the Editing template from the page.


Names are votes. See also: Too general category names above.

Top level categories.

Subcategories of Software. Looks well designed:

Applications category contains subcategories for various application groups, like GPS, Networking... This may be a problem if e.g. GPS belongs to Applications and Hardware too (and most of these stuff will belong to both). Maybe we could simply add articles to Applications AND GPS, which won't be subcategories of each other. Kempelen 20:54, 29 August 2008 (UTC)

Basic End User and Advanced End User categories may need to be created instead User, which is not enough specific term. Kempelen

Navigation templates

Exemples: Template:Om_2008.8, Template:OM2007.2

These are most useful to present small sets of chronological or otherwise well ordered information items. For example, it's obvious to offer navigation templates between these articles:

  • Openmoko produced smartphones {GTA01 Neo 1973, GTA02 Neo FreeRunner, GTA 03

(speculative)}

  • Distributions {2007.1, 2007.2, 2008.8 ASU, 2008.9, FSO, SHR, Qtopia, Debian}

In effect navigation templates create a subset of important pages presented sequentially. This corresponds more or less to a chapter in the user manual. We should not force them where they cannot create a CONSISTENT forth-and-back navigation between a GROUP OF PAGES.

Issues

  • The Distributions page feature a non-templated navigation box
  • We should name these templates distinctly. I suggest using a prefix like "NavBox:".
  • Visual design is by hand (not CSS), and not beautiful
  • Need to test positioning at bottom of article.

References

http://en.wikipedia.org/wiki/Wikipedia:Navigation_templates http://en.wikipedia.org/wiki/Wikipedia:Categories,_lists,_and_series_boxes

First discussion in the mailing list (Note: in the middle of a thread about left navboxes)

DolfjeBot1 proposals

Their is a bot on the openmoko wiki that's controlled by User:Dolfje. If you have tasks for the bot, please put them here.

Wiki engine issues

Can we please install/fix the following features for this wiki:

  • Math - the Tex math markup does not work currently. Test:
    • <math> z =\left (1-\left(\frac{P_{ind}}{101.325}\right)^{0.190263} \right ) \times \frac{87.828}{0.00198122} </math>
    • <math> P_{ind} </math>
  • Syntax Highlighting - makes code much more readable
  • GraphViz works with the commonly known dot language - it allows us to draw graphs using easy markup.
  • AnyWikiDraw allows us to draw svg diagrams directly on the wiki page.
  • Make visited links a different color.

Change Sitename

The name of this wiki is currently "Openmoko". I think it should be "Openmoko Wiki" for the following reasons:

Yes votes: Marko Knöbl, Minh

No votes:

Organize translations

I suggest moving the translations to sub-wikis, like the way wikipedia does it. Currently all translations show up in searches and under category-lists. --Johndoesacc 12:03, 25 August 2008 (UTC)


Rejected requests

When a requested Wiki Issue is voted for not to be done, it must be moved here, to make sure it won't get continously requested again.

  • Don't translate the wiki - rejected proposed by Minime August 2007, moved to rejected by Kempelen August 2008: the Documentation Team looks to support the idea.
  • Use namespaces to separate user-oriented and developper-oriented content. Assuming the default namespace is user-oriented that would exclude developper-oriented pages from searches (unless the user ticks the box, but who does ?). And it can't be done purely in the wiki, it needs admin time. Better to use categories and a prefix in the page name (like BlendeWiki). MinhHaDuong