User:Skierpage: Difference between revisions

    From KDE TechBase
     
    (8 intermediate revisions by the same user not shown)
    Line 1: Line 1:
    I first used [[Projects/KDE_on_Windows]] but now run Kubuntu as my main operating system.
    I first used [[Projects/KDE_on_Windows]] but now run Fedora KDE spin <s>Kubuntu</s> as my main operating system.
    I wrote an occasional journal of my adventures in getting Kubuntu working at [http://userbase.kde.org/User:Skierpage userbase.kde.org user page]


    I mostly do documentation and support for Semantic MediaWiki, an extension to MediaWiki.
    KDE web sites are confused whether I am spage or skierpage.


    == Techbase problems and what I'm going to do about them ==
    == New cleanup ==
    2011-11-14: I'm frustrated as hell trying to figure out a problem with KDE (Strigi not indexing my stuff), and TechBase is ''not'' helping.
    I managed to get set up for KDE development in 2020 or so and made a few fixes to Skrooge and Baloo/kfilemetadata. Returning to development in 2022, I found the same confusing mess of links to techbase, userbase, community, develop, etc. pages. So I've started to clean up techbase.


    Some wiki woes also apply to userbase.
    * https://techbase.kde.org/KDE_Frameworks - is this obsolete now we have
    https://develop.kde.org/docs/use/kxmlgui/  (latter URL looks wrong but it's all about KDE Frameworks).


    === Service page problems ===
    === KDEDevelopers group rights needed ===
    The Nepomuk blog's [http://nepomuk.kde.org/node/2 Documentation] page has a Strigi Service link that goes to [[Development/Tutorials/Metadata/Nepomuk/StrigiService]]
    I can't clean up these pages until I'm added to the [[Special:ListUsers|KDEDevelopers]] group:
    unfortunately this suffers from the same problems as the blog's Documentation page
    * [[Development/Tools]] - replace bad cgit link with invent.kde.org and lxr.kde.org
    * [[Getting Started]] - lots of fixes or delete/archive it
    * [[Projects]] - replace bad English Breakfast Network link with CI.


    * BUG: doesn't say where the source is
    == development ==
    * BUG: doesn't say where the API is
    Compare krita-devbox with https://github.com/MarceloHMariano/kde-dev-container
    * BUG: doesn't say what the service looks like. Is it a process I can look at?  What's the process name?


    * TODO: techbase needs to have {{tl|source}}, {{tl|api}}, {{tl|processname}} templates for creating links to these, and should have a series of form template that presents this sort of information about a project in an infobox:
    == Old pages ==
      <nowiki>{{</nowiki>service| source= | api= | processname= | bugtracker= | kdemodule= | blog= }}
    * [[/old user page]] from 2011 (!!)
     
    === Too many wikis! ===
    TODO: the split between userbase and techbase is dubious. I'm a user, but I want to go beyond the user documentation. You're just going to duplicate information like the processname, the blog, the bug tracker and the kdemodule in two wikis.
     
    And it turns out there's a third wiki, http://community.kde.org.  <nowiki><rant>That is completely f***ing ridiculous.</rant></nowiki>  ''Three times the infrastructure'' to maintain (Help pages, templates, interwiki links, common images, vandal patrolling), three copies of all these bugs, and for what?  Users are three times more likely to look in the wrong wiki.
     
    === Techbase minor bugs ===
    BUG: [[Template:Info]] is undocumented!  Use <nowiki><noinclude> </noinclude></nowiki> to document what templates do!
     
    BUG: [[Help:Contents]] says to use
      <nowiki><span class="bsBugLink bsError bsError-NoConnection">{{bug|123456}}</span></nowiki>
    surely this HTML formatting junk should be part of a template, i.e. {{formatted_bug|xxx}}
     
    BUG: Template:Template has a silly confusing warning
    "If this page is not already in the "Template" namespace, it should probably be migrated to that location."
     
    Instead, someone should just periodically look at [[Special:WhatLinksHere/Template:Template]] and see if pages outside Category:Template are using it.
     
    === techbase interwiki issues ===
    [[mediawikiwiki:Manual:Interwiki|interwiki prefixes]] let you link between wikis. (That first link is an example of one, <tt><nowiki>[[mediawikiwiki:</nowiki>''Some link''</tt> generates an external link to an article on mediawiki.or. But the [http://techbase.kde.org/api.php?action=query&meta=siteinfo&siprop=interwikimap interwiki prefixes on techbase] have some problems:
     
    * It should be easy to link from one wiki to another, using [userbase:http://userbase.kde.org/Special:MyLanguage/Quick Start], but it isn't set up.
     
    * There is a bug prefix, e.g. [[bug:1234|1234]], but why is it <tt>language="ᨅᨔ ᨕᨘᨁᨗ"</tt> attribute? Maybe that's why on userbase this doesn't do anything?
    * Why is there an empty bugs prefix, e.g.[[bugs:1234|1234]] ?
    * techbase and userbase have different interwiki maps, e.g. techbase has no wikipedia prefix, but userbase does e.g. [[wikipedia:Git]]?!
     
    === Stylistic issues ===
    * Don't capitalize each word in titles and section headings. It Makes the Wiki Look Imperious and Official, it conflicts with the default heading style (See the Toolbox links) and it makes linking to pages in the flow text flow unnatural to read. Compare
    ** If you're interested in contributing translations, your first step is to [[Special:MyLanguage/Translator Account|Get a Translator Account]]
    ** If you're interested in contributing translations, your first step is to [[Special:MyLanguage/Translator Account|get a translator account]]
     
    === Layout issues ===
    I think all these bugs are in the Chihuahua skin, and they all apply to userbase.kde.org as well.
     
    BUG: In three-column listings like [[Category:Template]] , the techbase wiki skin makes the listing overlap the right-hand "Share your Knowledge" column.
     
    BUG: In revision history the
    :Revision as of 21:55, 20 May 2009 by JRT (Talk | contribs)<br />(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
    crashes into the light header with [View the content page] [Discussion about the content page] icons.
     
    BUG: justified text looks bad in a narrow window.  Allow ragged right column
     
    BUG: when you select, the highlight color makes highlighted text look ''identical'' to a link. Try it, select this text and link [[Schedules]] and this text. You can't tell!
     
    MAYBE: pre text just goes on and on off the right side. Consider using the wrap attribute of pre so that stuff wraps.
     
    === TechBase problems fixed! ===
    * I fixed [[Template:Template]] to explain what it does.
    * I pulled in [[Template:Tl]] from Wikipedia, so that instead of fiddling with <nowiki>{{</nowiki> you can use e.g. {{tl|bug}} to generate a nicely-formatted <nowiki>{{</nowiki>[[Template:bug|bug]]}} which is also a link to a template.
    * I revived a "Browsing the code" section in [[Getting_Started#Browsing_the_code|Getting Started]], it's critical!  Someone deleted the old "Getting the source" section.

    Latest revision as of 09:29, 9 September 2022

    I first used Projects/KDE_on_Windows but now run Fedora KDE spin Kubuntu as my main operating system.

    KDE web sites are confused whether I am spage or skierpage.

    New cleanup

    I managed to get set up for KDE development in 2020 or so and made a few fixes to Skrooge and Baloo/kfilemetadata. Returning to development in 2022, I found the same confusing mess of links to techbase, userbase, community, develop, etc. pages. So I've started to clean up techbase.

    https://develop.kde.org/docs/use/kxmlgui/ (latter URL looks wrong but it's all about KDE Frameworks).

    KDEDevelopers group rights needed

    I can't clean up these pages until I'm added to the KDEDevelopers group:

    development

    Compare krita-devbox with https://github.com/MarceloHMariano/kde-dev-container

    Old pages