Wiki Week: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
(Add suggestions of outdated articles)
(More tips on what it can be useful to do.)
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
==The Next Wiki Week is 21-25.3.2016==
[[Category:Wiki Week]]
* See the [http://blog.qt.io/blog/2016/03/07/wiki-week-coming-up-in-two-weeks/ blog post] announcement.
We sporadically hold a [[:Category:Wiki Week|Wiki Week]] to bring order to this wiki.
* Coordination and discussion take place on this page and on the [http://forum.qt.io/category/16/wiki-discussion forum].
During wiki week we work together on these topics:
* [[Wiki Editing Hints]]: Tips on how to edit this wiki.
* Cleaning up the [[Wiki week active page list]]
* Marking old pages as needing updates


== Suggestions ==
This page will contain links to lists of pages that need to be checked or fixed.


=== Mobile portal ===
* I've stumbled upon this [[TopicWishlist | topic wishlist]]. --[[User:Wieland|Wieland]] ([[User talk:Wieland|talk]]) 15:43, 24 March 2016 (UTC)
It seems to me that we need to give more structure to [[Portal:Mobile]], and to update and augment the content. The goal is to categorise entries based on the use case (installation, development best practices, how-to's etc.). We started some work by structuring the Android section already, which could be taken as a blueprint. This should be completed, and the same should be done for the rest of the actively development platforms, especially iOS and Windows RT. Currently edits are being done at least by Marco_Piccolino (me) and Benlau. Anybody else who is willing to join the mobile effort is very welcome. Just join the forum discussion! For realtime discussions, you can find us daily on the [http://slackin.qtmob.org QtMob] Slack chat. --[[User:Marco_Piccolino|Marco_Piccolino]] ([[User talk:Marco_Piccolino|talk]]) 14:49, 11 March 2016 (CET)


=== QtQuick FAQ ===
= Tips =


Currently I don't find any FAQ for QtQuick/QML is available on Wiki yet. I would suggest to add this section.
Various pages provided by the wiki itself can be helpful in finding ways to improve the wiki – see the [[Special:SpecialPages|Special pages]] page – in particular:
;[[Special:UncategorizedCategories|Uncategorized Categories]]: You can make one category a sub-category of another by putting the usual category marker for the latter into the former's page.  One category may be a sub-category of several others, just as  a page may belong to several categories.  Remember, when trying to ''link to'' a category (rather than add a page to a category), to put an extra colon ''before'' the word Category, just inside the double square brackets.  (To put this page into the Wiki Week category, it has "Category:Wiki Week" inside double square brackets; where this page links to that category, it has ":Category:Wiki Week|Wiki Week" inside double square brackets.)
;[[Special:UncategorizedPages|Uncategorized Pages]]: Putting pages into categories makes them easier to find.  Many [[:Category:Articles needing cleanup|Articles needing cleanup]] would also benefit from categorization.
;[[Special:Categories|Categories]]: The big list of all categories to which it might be worth adding a page or category.
;[[Special:UnusedCategories|Unused Categories]]: These are category pages with content but no pages in the category; often, they should just be turned into ordinary pages (and added to suitable categories) instead of category pages.
;[[Special:WantedPages|Wanted Pages]]: These are pages that somewhere links to but that don't exist; maybe someone mis-typed the text inside some square brackets; or they linked to a page they intended to write but never got round to it.
;[[:Category:Delete]]: This is the page for pages and categories someone thinks should be deleted.  Be sure to check their Talk pages (see Discussion tab at top of page) in case there have been objections or suggestions for better things to do about the page.  If it's more appropriate to move the content elsewhere, it may be constructive to redirect the old page to the new, at least until everything that links to it has been updated.  Always check "What links here" in the page side-bar before actually deleting it.
;[[Special:ListRedirects|List of Redirects]]: Redirected pages are usually worth deleting (assuming there aren't external links to it); find what links to them, if anything, and change where they link to, based on the redirect, until there's nothing left linking to the redirected page, which can then safely be deleted.


--[[User:Benlau|Benlau]] ([[User talk:Benlau|talk]]) 04:21, 13 March 2016 (UTC)
Speaking of redirects, they are useful when you want to move content; move the page content to its new home and replace it with "<kbd>#Redirect:</kbd>" followed by a wiki-link to the content's new home; that'll typically be the new home page's title in double square brackets, possibly with a fragment identifier if you've made the old page a sub-section of another.


=== Outdated Articles? ===
Have a rummage around the [[Special:SpecialPages|Special pages]] page and you'll likely find other useful resources.
 
* [[Best Practices for Designing Mobile UI - Qt Wiki]] -- [[User:Benlau|Benlau]] ([[User talk:Benlau|talk]])
 
==The First Wiki Week was 18-22.5.2015==
See the [http://blog.qt.io/blog/2015/05/05/announcing-wiki-week/ blog post] announcement.
 
==Things to do==
During wiki week we will work together on these topics:
 
* Cleaning up [[Wiki week active page list]]
* Marking old pages as needing updates
* Review pages that contain larger issues: [[:Category:WW issues]]
 
This page will contain links to lists of pages that need to be checked or fixed.


== Reminder: Code Formatting ==
== Reminder: Code Formatting ==
Line 36: Line 29:
For example .pro files need to have <code> <code lang="make"></code> defined in their code block.
For example .pro files need to have <code> <code lang="make"></code> defined in their code block.


== Suggestions ==
== More hints ==
=== Localization improvement: Dedicated wiki for each language ===
* [[Wiki Editing Hints]]: Tips on how to edit this wiki.
The organization of articles in languages others then English is pretty bad. I suggest to do it like Wikipedia and have subdomains with dedicated mediawikis for all supported languages and create links between articles in different language versions.
I've put together a somewhat lengthy explanation of what is going wrong with the current localization scheme and why I think this is the way to go to achieve the best user experience; it can be found on the forum: [http://forum.qt.io/topic/54119/wiki-week/6] --[[User:Wieland|Wieland]] ([[User talk:Wieland|talk]]) 20:30, 14 May 2015 (UTC)
 
=== Removing pages ===
Symbian is dead. Shall we remove Symbian related pages? I would say yes. But what about Qt3? There is at least one project I know (the unholy KDE3 fork Trinity) that still uses Qt3, although they are "maintaining" their own Qt3 fork. Shall Qt3 related pages be removed, too? Shall we send an e-mail to the Trinity guy(s)? --[[User:Wieland|Wieland]] ([[User talk:Wieland|talk]]) 23:28, 15 May 2015 (UTC)
: I vote for archiving, not deletion. --[[User:JKSH|JKSH]] ([[User talk:JKSH|talk]]) 14:44, 18 May 2015 (UTC)
 
=== Clear distinction between Qt versions ===
I think there should be a clear, big fat warning on top of every article that specifically targets Qt4. --[[User:Wieland|Wieland]] ([[User talk:Wieland|talk]]) 23:29, 15 May 2015 (UTC)
: Agreed. Use [[Template:Outdated]]. --[[User:JKSH|JKSH]] ([[User talk:JKSH|talk]]) 14:44, 18 May 2015 (UTC)
 
=== List of needed articles ===
Some questions pop up on the forums again and again. I think it would be of great value if we could identify those questions and make a list of articles that need to be written. --[[User:Wieland|Wieland]] ([[User talk:Wieland|talk]]) 23:43, 15 May 2015 (UTC)
 
 
 
[[Category:Wiki week]]

Latest revision as of 18:10, 6 January 2017

We sporadically hold a Wiki Week to bring order to this wiki. During wiki week we work together on these topics:

This page will contain links to lists of pages that need to be checked or fixed.

Tips

Various pages provided by the wiki itself can be helpful in finding ways to improve the wiki – see the Special pages page – in particular:

Uncategorized Categories
You can make one category a sub-category of another by putting the usual category marker for the latter into the former's page. One category may be a sub-category of several others, just as a page may belong to several categories. Remember, when trying to link to a category (rather than add a page to a category), to put an extra colon before the word Category, just inside the double square brackets. (To put this page into the Wiki Week category, it has "Category:Wiki Week" inside double square brackets; where this page links to that category, it has ":Category:Wiki Week|Wiki Week" inside double square brackets.)
Uncategorized Pages
Putting pages into categories makes them easier to find. Many Articles needing cleanup would also benefit from categorization.
Categories
The big list of all categories to which it might be worth adding a page or category.
Unused Categories
These are category pages with content but no pages in the category; often, they should just be turned into ordinary pages (and added to suitable categories) instead of category pages.
Wanted Pages
These are pages that somewhere links to but that don't exist; maybe someone mis-typed the text inside some square brackets; or they linked to a page they intended to write but never got round to it.
Category:Delete
This is the page for pages and categories someone thinks should be deleted. Be sure to check their Talk pages (see Discussion tab at top of page) in case there have been objections or suggestions for better things to do about the page. If it's more appropriate to move the content elsewhere, it may be constructive to redirect the old page to the new, at least until everything that links to it has been updated. Always check "What links here" in the page side-bar before actually deleting it.
List of Redirects
Redirected pages are usually worth deleting (assuming there aren't external links to it); find what links to them, if anything, and change where they link to, based on the redirect, until there's nothing left linking to the redirected page, which can then safely be deleted.

Speaking of redirects, they are useful when you want to move content; move the page content to its new home and replace it with "#Redirect:" followed by a wiki-link to the content's new home; that'll typically be the new home page's title in double square brackets, possibly with a fragment identifier if you've made the old page a sub-section of another.

Have a rummage around the Special pages page and you'll likely find other useful resources.

Reminder: Code Formatting

A guideline to people writing code examples on the wiki.

For example .pro files need to have

 <code lang="make">

defined in their code block.

More hints