UserBase development

[Anne Wilson-5]

Apoligies if this turns up twice.  After 18 hours I stil haven't seen it.

Some of you may have read my recent blogs, "Announcing #userbase" and
"UserBase looks to the future".  I invited people to come along and chat about
what needs changing in UserBase.  Several people did, and it was decided that
we would cooperate using a googledoc, then follow it up with an IRC meeting.  
Here is a summary of what we discussed:

    * Style issues
          o Anne pointed to http://userbase.kde.org/Different_Style_Pages
          o http://userbase.kde.org/KOrganizer was agreed to be a suitable
model
          o A good half of pages are consistent with that, a significant
number are not
          o The_madman and annew agreed to plough through existing pages, with
the aim of making all consistent.
          o annew asked for help in identifying which applications need the
third-party symbol
          o There are far too many empty pages
          o Nightrose agreed to nag developers to write about developer tools
(it was agreed that this should only be a short description, for
identification of a tool, and a link to relevant techbase pages)
          o There is a need to find people with an interest in the
accessibility applications
          o Mogger and irina_r both felt that it was too difficult to find a
good beginners' guide to style


this led on to thinking about

    * What do new contributors most need to see?
          o We currently have three pages -
                + http://userbase.kde.org/Help:Contents
                + http://userbase.kde.org/Help:Editing
                + http://userbase.kde.org/UserBase/Guidelines
          o irina_r said the link at the top of the pages to Help:Contents was
good
          o Guidelines are linked from the Welcome page and from
http://userbase.kde.org/UserBase
          o That third link is probably unhelpful - Guidelines makes necessary
statements, but a new contributor would find that link more useful if it
pointed to Help:Contents.
          o Nightrose pointed out that not everyone arrives via the Welcome
page.  It was decided that Help in the Navigation panel must point to a
beginners' page.
          o irina_r pointed out that it must not make any assumptions.  It
should start with whether an account is needed, and how to get an account
          o Mogger, irina_r and Bou all felt that the available help is too
scattered around, and must be easier to find.
          o Mogger suggested that it should have sections, too on topics like
edit articles, add new articles, add translations
          o Bou and Mogger are going to try to put together an outline page
for this.
          o It is likely that we'll want to make changes to the Navigation
panel to make these pages more visible


    * Format translation - mediawiki to docbook
          o Burkhard Lück's request for an extension to help with this was
discussed
          o yurchor was strongly against it, apparently feeling that docbook
should be the one and only form of documentation.  It was explained that some
people wanted to use wiki for drafting, prior to docbook.
          o tstaerk looked at the mediawiki to docbook bridge extension
document, and said it was difficult to understand, and might need some
specialist knowledge as well as considerable time.


    * Language translation
          o yurchor is concerned about the frequency of changes in userbase
making translations difficult
          o tsdgeos is concerned that pages, once translated, may not be kept
in sync with English updates.  He would like to see a system where
                + a tool is used to extract pages to .po syntax
                + putting them into svn
                + when the translator uploads his finished work
                + userbase is automatically updated from that
          o we need to see whether such an extension actually exists
          o irina_r offered to try translating some pages into Dutch.  It was
suggested that she should look at Special:PopularPages, concentrating on pages
that have been marked Consistent on Different_Style_Pages, as they are less
likely to need an imminent update.
          o tstaerk repeated his conviction that moving to namespaces for
languages would be a big improvement.  It would enable searches to always
return results in the correct language (say, English plus locale language).  
Apparently it would also make the language suffix in pagenames unnecessary,
too.  However, this is not a trivial task.


    * Other tools considered
          o Three people would like to see a last-changed-date on pages.  
There was not time to consider how that should be done
          o tstaerk would like to see a visitor counter on pages - these
numbers are already stored, it seems, for the statistics pages, so it's a
matter of finding the tool to display them.
          o Page rating had been considered in the document above, but was not
discussed at the meeting

There have been some developments since then.  Bou and Mogger are consulting
about requirements for re-writing the Help pages, with Irina being consulted
as a user coming new to editing pages.

The forum team have set up a mediawiki sandbox for me to explore and hopefully
find some answers to resolving some of the problems we've had with UserBase.  
We intend to install some extensions there for testing.

We realise now that userbase and techbase share the same skin, so that some
changes are impossible without affecting techbase.  We hope to set up some
discussions with the techbase maintainer(s) once we are clearer about the
issues.

The first extensions that we will look at are concerned with documentation and
translation.  'Translate' ouputs a .po file, which should help language
translators.  There are tools for both export and import.  Any generated pages
that are considered suitable for official documentation could then be exported
via the mediawiki2docbook bridge.  We are looking at the possibility of making
most of this into an automatic system.  Sayak Banerjee (of the forum team) has
offered to do any scripting necessary to link the parts of the process.

If any one is interested in reading the whole of the discussion document, it
can be found at
http://docs.google.com/Doc?docid=0ASzMxRsf3mdcZGZmcXc3bXpfOGY2NHF0cmY2&hl=en

The document is open for editing, so please do add comments and suggestions.  
I'll apologise now for the look of it.  It's a bit messy by now, since there
is two weeks' worth of talk.

Anne (annew)
--
New to KDE4? - get help from http://userbase.kde.org
Just found a cool new feature?  Add it to UserBase


_______________________________________________
kde-www mailing list
kde-www@...
https://mail.kde.org/mailman/listinfo/kde-www