Difference between revisions of "User:Skierpage"

Jump to: navigation, search
m (fix link)
(frustrated with TechBase, list of problems)
Line 3: Line 3:
  
 
I mostly do documentation and support for Semantic MediaWiki, an extension to MediaWiki.
 
I mostly do documentation and support for Semantic MediaWiki, an extension to MediaWiki.
 +
 +
== Techbase problems and what I'm going to do about them ==
 +
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.
 +
 +
=== Service page problems ===
 +
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]]
 +
unfortunately this suffers from the same problems as the blog's Documentation page
 +
 +
* BUG: doesn't say where the source is
 +
* BUG: doesn't say where the API is
 +
* 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:
 +
  <nowiki>{{</nowiki>service| source= | api= | processname= | bugtracker= | kdemodule= | blog= }}
 +
 +
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.
 +
 +
BUG: WTF happened to [[Getting Started]]? It used to have "Getting the source", now that's gone!
 +
 +
=== 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 [[WhatLinksHere/Template:Template]] and see if pages outside Category:Template are using it.
 +
 +
BUG: pull 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.
 +
 +
BUG: need a template or namespace for linking to Wikipedia. A template could be smart about language.
 +
 +
BUG: have a namespace for linking to userbase
 +
 +
 +
==== Layout bugs ====
 +
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
 +
 +
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 done ==
 +
* fixed [[Template:Template]] to explain what it does
 +
*

Revision as of 22:42, 14 November 2011

I first used Projects/KDE_on_Windows but now run Kubuntu as my main operating system. I wrote an occasional journal of my adventures in getting Kubuntu working at userbase.kde.org user page

I mostly do documentation and support for Semantic MediaWiki, an extension to MediaWiki.

Contents

Techbase problems and what I'm going to do about them

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.

Service page problems

The Nepomuk blog's Documentation page has a Strigi Service link that goes to Development/Tutorials/Metadata/Nepomuk/StrigiService unfortunately this suffers from the same problems as the blog's Documentation page

  • BUG: doesn't say where the source is
  • BUG: doesn't say where the API is
  • BUG: doesn't say what the service looks like. Is it a process I can look at? What's the process name
 {{service| source= | api= | processname= | bugtracker= | kdemodule= | blog= }}

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.

BUG: WTF happened to Getting Started? It used to have "Getting the source", now that's gone!

Techbase minor bugs

BUG: Template:Info is undocumented! Use <noinclude> </noinclude> to document what templates do!

BUG: Help:Contents says to use

 <span class="bsBugLink bsError bsError-NoConnection"><span class="bsBugLink bsError bsError-NoConnection">{{bug|123456}}</span></span>

surely this HTML formatting junk should be part of a template, i.e. Template:Formatted bug

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 WhatLinksHere/Template:Template and see if pages outside Category:Template are using it.

BUG: pull in Template:Tl from Wikipedia, so that instead of fiddling with {{ you can use e.g. {{bug}} to generate a nicely-formatted {{bug}} which is also a link to a template.

BUG: need a template or namespace for linking to Wikipedia. A template could be smart about language.

BUG: have a namespace for linking to userbase


Layout bugs

BUG: In three-column listings like , 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)
(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

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 done


KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V.Legal