Wiki Team Page: Difference between revisions

From KDE UserBase Wiki
No edit summary
No edit summary
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
== UserBase Wiki Team ==
== UserBase Wiki Team ==


[https://notes.kde.org/p/UserbaseWiki Notes] from the Akademy BOF
[https://phabricator.kde.org/project/view/91/ KDE Documentation on Phabricator]
 
[https://notes.kde.org/p/UserbaseWiki Notes] from the 2017 Akademy BOF [https://userbase.kde.org/User:Valoriez BoF notes] 2018


* [[User:Claus chr/Welcome|New welcome page]]! I have started it in my "personal" space - everyone can edit.
* [[User:Claus chr/Welcome|New welcome page]]! I have started it in my "personal" space - everyone can edit.
Line 10: Line 12:
Use <nowiki>[[Category:New page]]</nowiki> 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 <nowiki>[[Category:New page]]</nowiki> to <nowiki>[[Category:Good page]]</nowiki> (it won't be displayed on the actual page - it is just there to help us keep track of our work.
Use <nowiki>[[Category:New page]]</nowiki> 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 <nowiki>[[Category:New page]]</nowiki> to <nowiki>[[Category:Good page]]</nowiki> (it won't be displayed on the actual page - it is just there to help us keep track of our work.


Plan of attack:
Slides from the documentation workshop at Akademy 2018: [[File:Tech writing-akademy18.odp]]
 
=== Plan of attack ===
 
# Plasma pages - at least the general stuff.  
# Plasma pages - at least the general stuff.  
# Create pages for missing applications -- at least short description, logo, screenshot and links. Details can come later.
# Create pages for missing applications -- at least short description, logo, screenshot and links. Details can come later.
Line 19: Line 24:
#* [[Update an Image]] needs images
#* [[Update an Image]] needs images


Needs attention at some point:
=== Needs attention at some point ===
# [[Stats]] - most of the statistics no longer works
 
# [[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 ([https://www.mediawiki.org/wiki/Help:Extension:Translate/Statistics_and_reporting see more here]).
#* <code><TopTenPages /></code> doesn't seem to be reckognized any more.
# The Translate system behaves somewhat unpredictably.
#* Pages that have been marked for translation does not always show up in the <tt>Special:LanguageStats</tt> page.
#* The given number of translation units that needs attention is sometimes not correct
#* In the translation interface (<tt>Special:Translate</tt>) when displaying differences the whole page is being shown rather than just the actual unit.
# Some pages are not linked to: fx [[KDE_System_Administration]]
# Some pages are not linked to: fx [[KDE_System_Administration]]
# Some pages are probably not needed anymore:  
# Some pages are probably not needed anymore:  
Line 28: Line 40:
#* Krita manuals ?
#* Krita manuals ?
#* [[Nepomuk]]
#* [[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 alse [[Pages for Deletion]]
# Some pages are badly in need of up to date information
#* [[Plasma/Plasmoids]]
# There are several references to Strigi, sRts, KControl, Kicker
# There are several references to Strigi, sRts, KControl, Kicker
# The mediawiki installation: It is old - may need updating, which might solve other problems
# Searching for users: the search box is not as useful as it might be - it finds everything including all translations
# Searching for contributors and admins: The templates and DPL examples in [[User:Claus chr/DPL]] have been updated - they should work as originally intended.
#* The DPL extension is very old and has been superseeded by DynamicPageLoad 3 &mdash; should we update (that would require updating mediawiki as well)?
# Application pages should not have version numbers in their name (like [[KAddressBook 4.4]]).


Needs to be added to/changed in help page:
=== Needs to be added to/changed in help page ===
# The new <nowiki>{{Emoji}}</nowiki> template
# The new <nowiki>{{Emoji}}</nowiki> template


Pages that are not linked to
=== Pages that are not linked to ===
# [[Phonon]]
# [[Baloo]]
# [[Accessibility]] (and pages linked from there)
# [[Accessibility]] (and pages linked from there)
# [[Configure_your_desktop]] - this page should be updated or retired
{{Warning|1=Don't use the "what links here" wiki tool to check that a page is properly linked &ndash; it is no longer reliable. Use the <nowiki>{{LinksTo|...}}</nowiki> template instead. Find this and other search tools [[User:Claus chr/Search|here]].}}

Revision as of 05:56, 6 November 2018

UserBase Wiki Team

KDE Documentation on Phabricator

Notes from the 2017 Akademy BOF 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.
    • The existing help pages needs 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]] (it won't be displayed on the actual page - it is just there to help us keep track of our work.

Slides from the documentation workshop at Akademy 2018: File:Tech writing-akademy18.odp

Plan of attack

  1. Plasma pages - at least the general stuff.
  2. Create pages for missing applications -- at least short description, logo, screenshot and links. Details can come later.
  3. Existing application pages - make sure basic info is up to date, links working. Determine if content needs rewriting
  4. Contributors pages

Needs attention at some point

  1. Stats - most of the statistics no longer works.
    • {{Special:TranslationStats produces what look like an image frame that can't find the associated image file. TranslationStats is part of the Translate extension (see more here).
    • <TopTenPages /> doesn't seem to be reckognized any more.
  2. The Translate system behaves somewhat unpredictably.
    • Pages that have been marked for translation does not always show up in the Special:LanguageStats page.
    • The given number of translation units that needs attention is sometimes not correct
    • In the translation interface (Special:Translate) when displaying differences the whole page is being shown rather than just the actual unit.
  3. Some pages are not linked to: fx KDE_System_Administration
  4. Some pages are probably not needed anymore:
  5. Some pages are badly in need of up to date information
  6. There are several references to Strigi, sRts, KControl, Kicker
  7. The mediawiki installation: It is old - may need updating, which might solve other problems
  8. Searching for users: the search box is not as useful as it might be - it finds everything including all translations
  9. Searching for contributors and admins: The templates and DPL examples in User:Claus chr/DPL have been updated - they should work as originally intended.
    • The DPL extension is very old and has been superseeded by DynamicPageLoad 3 — should we update (that would require updating mediawiki as well)?
  10. Application pages should not have version numbers in their name (like KAddressBook 4.4).

Needs to be added to/changed in help page

  1. The new {{Emoji}} template

Pages that are not linked to

  1. Accessibility (and pages linked from there)
  2. Configure_your_desktop - this page should be updated or retired

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 here.