Wiki Team Page: Difference between revisions
No edit summary |
RogueScholar (talk | contribs) (General cleanup and linking of many items that needed them) |
||
| (37 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
== UserBase problems == | |||
There is a '''[[Wiki Team Page/Problems|list of problems with the wiki]]''' that we should like to have solved. | |||
== UserBase Wiki Team == | == UserBase Wiki Team == | ||
<strike>[https://phabricator.kde.org/project/view/91/ KDE Documentation on Phabricator]</strike> | |||
[https://notes.kde.org/p/UserbaseWiki Notes] from the Akademy BOF | <strike>[https://notes.kde.org/p/UserbaseWiki Notes] from the 2017</strike> Akademy BOF | ||
[[User:Valoriez|BoF notes]] 2018 | |||
* A new [[Introduction to new contributors]] - should be short and focus on the bare essentials; how to get an account, how to get in contact, a few things to avoid when editing existing pages, links to detailed info. | * [[User:Claus chr/Welcome|New welcome page]]! I have started it in my personal user space, but anyone can edit it. | ||
** The existing help pages | * A new [[Introduction to new contributors]] - it should be short and focus on the bare essentials; how to get an account, how to get in contact, a few things to avoid when editing existing pages, links to detailed info, etc. | ||
** The existing help pages need cleanup and restructuring. | |||
Use < | Use <span style="font-family: monospace; font-weight: 500;">[[[[:Category:New page]]]]</span> at the bottom of any page that we are currently working on (wheather it is a new page or an old page under revision. When the work is done change <span style="font-family: monospace; font-weight: 500;"><nowiki>[[Category:New page]]</nowiki></span> to <span style="font-family: monospace; font-weight: 500;">[[[[:Category:Good page]]]]</span>. (They won't be displayed on the actual page, these are hidden categories - they simply help us keep track of our work.) | ||
Plan of attack | Slides from the documentation workshop at Akademy 2018: [[Media:Tech writing-akademy18.odp|Tech writing-akademy18.odp]] | ||
# Plasma pages - at least the general stuff. | |||
# Create pages for missing applications | === Plan of attack === | ||
# Plasma pages - at least the general stuff. | |||
# Create pages for missing applications — at least containing a short description, logo, screenshot and links…details can come later. | |||
#* [[GCompris]] | #* [[GCompris]] | ||
#* [[Minuet]] | #* [[Minuet]] | ||
# Existing application pages - make sure basic info is up to date | # Existing application pages - make sure the basic info is up to date and the links are working. Also determine if the content needs rewriting. | ||
# Contributors pages | # Contributors pages | ||
#* [[Update an Image]] needs images | #* [[Update an Image]] needs images | ||
=== Needs attention at some point === | |||
<strike> | |||
# [[Stats]] - most of the statistics no longer works. | |||
#* <code>{{Special:TranslationStats</code> produces what look like an image frame that can't find the associated image file. TranslationStats is part of the Translate extension ([[mediawikiwiki:Help:Extension:Translate/Statistics and reporting|Extension:Translate/Statistics and reporting]] has more to say about it). | |||
#* <code><TopTenPages /></code> doesn't seem to be recognized any more.</strike> | |||
# The Translate system behaves somewhat unpredictably.<strike> | |||
#* Pages that have been marked for translation do not always show up in [[Special:LanguageStats]]. | |||
#* The given number of translation units that needs attention is sometimes not correct.</strike> | |||
#* In the [[Special:Translate|translation interface]], when displaying differences, the whole page is being shown rather than just the actual unit. | |||
# Some pages are not linked to, e.g. [[KDE System Administration]]. | |||
# Other pages are probably not needed anymore: | |||
#* [[Tutorials/KDE3 to KDE SC 4]] | |||
#* [[Browser Configuration/Opera]] | |||
#* [[Browser Configuration]] | |||
#* Krita manuals? | |||
#* [[Nepomuk]] | |||
#* [[KNode]] | |||
#* [[Kdenlive/Manual/Effects/Misc/keysplillm0pup]] | |||
#* [[KOffice]], [[KWord]], [[KCells]], [[KChart]], [[KFormula]], [[KPlato]], … - Are the old KOffice apps completely dead now? What about the tutorials, should they be adapted for Calligra Word? | |||
#* See also [[Propose Deletion]] and the [[:Category:Proposed deletion|Proposed deletion tracking category]], | |||
# Some pages are badly in need of up-to-date information. | |||
#* [[Plasma/Plasmoids]] | |||
# There are several references to Strigi, sRts, KControl, Kicker… | |||
# <strike>The MediaWiki installation: It is old and may need updating, which might solve other problems.</strike> | |||
# Search experience for users: The search box is not as useful as it might be - it finds everything, including all the translations. | |||
# Search experience for contributors and admins: The templates and DPL examples no longer work! | |||
# Application pages should not have version numbers in their name (like [[KAddressBook 4.3]]). | |||
# Go through settings pages to make sure everything is properly linked to. | |||
# Pages that need to be improved: | |||
#* [[Dolphin/File Management]] | |||
#* [[Plasma application launchers]] | |||
#* [[Klipper/How to search in phone books using Klipper]] | |||
#* [[Konversation/Configuring SASL authentication]] needs new images to match changes text. | |||
=== Needs to be added to/changed in help page === | |||
# The new {{Tl|Emoji}} template | |||
=== [[Special:LonelyPages|Pages that are not linked to]] === | |||
# [[Accessibility]] (and pages linked from there) | |||
# [[Configure your desktop]] - this page should be updated or retired. | |||
# [[QCA]] - this probably belongs on TechBase or Community. | |||
{{Warning|1=Don't use the [[Special:WhatLinksHere/Wiki Team Page|What links here]] wiki tool to check that a page is properly linked – it is no longer reliable!<strike> Use the {{Tl|LinksTo}} template instead; find this and other search tools on [[User:Claus chr/Search]].}}</strike> | |||
=== Admin === | |||
; Cleanup of "dead" pages : Some pages have been deleted but their translations have been left behind. They don't seem to linger in the translate system (need to confirm this). Do the translated units still exist? ''This involves several pages in the Kexi Manual.'' | |||
; Archive obsolete pages : UserBase contains some pages that are no longer relevant and should be archived. We need to find out how to do this so that translations are archived with the original page rather than being left behind. In the meantime, such pages should be marked by adding the {{Tl|ObsoletePage}} template; that will add a warning box to the page and place it in the [[:Category:Obsolete|Obsolete tracking category]]. | |||
; Clean up categories : <ul><li><del>Make sure that all (English) categories are listed in the [[:Category:Pages|Pages]] category in English.</del></li><li>Remove the [[:Category:Terminology|Terminology]] category?</li><li>Should we have a special category for manuals?</li><li>Move some categories from [[:Category:Pages]] to [[:Category:Pages in Turkish]].</li></ul> | |||
[[Category:Admin]] | |||
Latest revision as of 03:21, 14 November 2024
UserBase problems
There is a list of problems with the wiki that we should like to have solved.
UserBase Wiki Team
KDE Documentation on Phabricator
Notes from the 2017 Akademy BOF
BoF notes 2018
- New welcome page! I have started it in my personal user space, but anyone can edit it.
- A new Introduction to new contributors - it should be short and focus on the bare essentials; how to get an account, how to get in contact, a few things to avoid when editing existing pages, links to detailed info, etc.
- The existing help pages need cleanup and restructuring.
Use [[Category:New page]] at the bottom of any page that we are currently working on (wheather it is a new page or an old page under revision. When the work is done change [[Category:New page]] to [[Category:Good page]]. (They won't be displayed on the actual page, these are hidden categories - they simply help us keep track of our work.)
Slides from the documentation workshop at Akademy 2018: Tech writing-akademy18.odp
Plan of attack
- Plasma pages - at least the general stuff.
- Create pages for missing applications — at least containing a short description, logo, screenshot and links…details can come later.
- Existing application pages - make sure the basic info is up to date and the links are working. Also determine if the content needs rewriting.
- Contributors pages
- Update an Image needs images
Needs attention at some point
Stats - most of the statistics no longer works.{{Special:TranslationStatsproduces what look like an image frame that can't find the associated image file. TranslationStats is part of the Translate extension (Extension:Translate/Statistics and reporting has more to say about it).<TopTenPages />doesn't seem to be recognized any more.
- The Translate system behaves somewhat unpredictably.
- Pages that have been marked for translation do not always show up in Special:LanguageStats.
The given number of translation units that needs attention is sometimes not correct.- In the translation interface, when displaying differences, the whole page is being shown rather than just the actual unit.
- Some pages are not linked to, e.g. KDE System Administration.
- Other pages are probably not needed anymore:
- Tutorials/KDE3 to KDE SC 4
- Browser Configuration/Opera
- Browser Configuration
- Krita manuals?
- Nepomuk
- KNode
- Kdenlive/Manual/Effects/Misc/keysplillm0pup
- KOffice, KWord, KCells, KChart, KFormula, KPlato, … - Are the old KOffice apps completely dead now? What about the tutorials, should they be adapted for Calligra Word?
- See also Propose Deletion and the Proposed deletion tracking category,
- Some pages are badly in need of up-to-date information.
- There are several references to Strigi, sRts, KControl, Kicker…
The MediaWiki installation: It is old and may need updating, which might solve other problems.- Search experience for users: The search box is not as useful as it might be - it finds everything, including all the translations.
- Search experience for contributors and admins: The templates and DPL examples no longer work!
- Application pages should not have version numbers in their name (like KAddressBook 4.3).
- Go through settings pages to make sure everything is properly linked to.
- Pages that need to be improved:
- Dolphin/File Management
- Plasma application launchers
- Klipper/How to search in phone books using Klipper
- Konversation/Configuring SASL authentication needs new images to match changes text.
Needs to be added to/changed in help page
- The new {{Emoji}} template
Pages that are not linked to
- Accessibility (and pages linked from there)
- Configure your desktop - this page should be updated or retired.
- QCA - this probably belongs on TechBase or Community.
Warning
Don't use the What links here wiki tool to check that a page is properly linked – it is no longer reliable! Use the {{LinksTo}} template instead; find this and other search tools on User:Claus chr/Search.
Admin
- Cleanup of "dead" pages
- Some pages have been deleted but their translations have been left behind. They don't seem to linger in the translate system (need to confirm this). Do the translated units still exist? This involves several pages in the Kexi Manual.
- Archive obsolete pages
- UserBase contains some pages that are no longer relevant and should be archived. We need to find out how to do this so that translations are archived with the original page rather than being left behind. In the meantime, such pages should be marked by adding the {{ObsoletePage}} template; that will add a warning box to the page and place it in the Obsolete tracking category.
- Clean up categories
Make sure that all (English) categories are listed in the Pages category in English.- Remove the Terminology category?
- Should we have a special category for manuals?
- Move some categories from Category:Pages to Category:Pages in Turkish.