[Nepomuk] Re: Fwd: [kde-runtime/active-development/master] nepomuk: remove references to "nepomuk" and "strigi" in the UI that users are likely to see
Sebastian Trüg
trueg at kde.org
Fri Jul 29 13:45:42 CEST 2011
Hi Aaron,
On 07/28/2011 03:02 PM, Aaron J. Seigo wrote:
> hi guys ...
>
> it's that time of year again.. you know, the day after release where i
> suddenly notice that once again there are dozens of translated strings in
> nepomuk code that the user will see which contain the words "nepomuk" and/or
> "strigi".
>
> yep, pretty well every. single. release. we manage to ship a bunch of "Nepomuk
> this" and "Strigi that" to our users, most of whom just look at those messages
> and wonder what we're smoking. "What is .. nee-puh-mook?"
>
> getting nepomuk and strigi into top flight shape technically is of course of
> paramount importance. nothing really matters if it doesn't work well, right?
> right.
>
> but it's equally important to make sure that the user experience is good.
> because if it isn't, it doesn't matter how well nepomuk runs, our users will
> think it is garbage.
>
> even worse, most of our users do not know the difference between nepomuk and
> the desktop it seems so well integrated with, so these leakages of jargon
> affect not only the perception of nepomuk, but everything included in the
> Plasma Desktop as well.
>
> this is not cool. we must improve on this.
>
> now, i apologize right here and now for the this lecture because it is not fun
> to read, i'm sure. it's not fun to write either. i'd rather be doing other
> things, too. :) but this is IMPORTANT, and it keeps happening. i keep talking
> about it, i keep fixing things on your behalf but we keep repeating the same
> simple errors over and over and over again.
>
> so .. here's the easy solution which will make our user's lives better, which
> means our lives as KDE hackers improves too:
>
> whenever you are wrapping a message in i18n() and it contains the word
> "nepomuk", "strigi" or any other similar bit of jargon, STOP! if this will
> reasonably be shown to the user in the normal day-to-day user interface (so
> items like server processes that don't show UI get a pass here), replace the
> jargon with understandable, every-day, lay-person language.
>
> it is not hard to do, it takes just a moment of time and the least bit of
> self-discipline. it is the most valuable .5 seconds you are likely to spend in
> terms of payback: other things with that kind of immediate user impact usually
> take a lot longer to accomplish.
>
>
> with that out of the way, someone needs to go through the backup GUI and de-
> jargon the strings.
>
> and please, can we all agree to work on this together? to make Plasma Desktop
> a Jargon Free(tm) zone? to ship 4.8 without user visible jargon?
>
> thanks for your understanding and indulgence ...
Well, I understand the problem. And I normally try to keep "Strigi" out
of the messages. But I have big problems with the term "Desktop Search"
being used as a replacement for Nepomuk everywhere. It is simply not
accurate. Nepomuk is not desktop search. Desktop search is a
side-product of it. Now this might be of no interest to you and most
users but it is the reason why the term "Nepomuk" creeps into messages
every once in a while. So far I did not find a suitable alternative to
"Desktop Search" or "Nepomuk" yet.
And to be a real pina: why is it OK for the desktop being plastered with
the term "Plasma"? It is a term as random as "Nepomuk". Why isn't it
"KDE desktop" instead? Why do we confuse users with that? (I suppose
this has been discussed ten times over and I simply forgot or never
followed the discussions. Still, from a non-KDE perspective it does not
make much sense - especially since the whole KDE SC business never
really worked out. Anyway, enough ranting...)
Cheers,
Sebastian
> ---------- Forwarded Message ----------
>
> Subject: [kde-runtime/active-development/master] nepomuk: remove references to
> "nepomuk" and "strigi" in the UI that users are likely to see
> Date: Thursday, July 28, 2011, 14:50:03
> From: Aaron Seigo <aseigo at kde.org>
> To: kde-commits at kde.org
>
> Git commit d6a1cf3dfbd9f7ed5dceadc8e401451d7cebb9d4 by Aaron Seigo.
> Committed on 28/07/2011 at 14:49.
> Pushed by aseigo into branch 'active-development/master'.
>
> remove references to "nepomuk" and "strigi" in the UI that users are likely to
> see
>
> M +2 -2 nepomuk/kioslaves/search/kio_nepomuksearch.cpp
> M +8 -8 nepomuk/kcm/nepomukserverkcm.cpp
> M +1 -1 nepomuk/kioslaves/nepomuk/kio_nepomuk.cpp
> M +2 -2 nepomuk/controller/systray.cpp
> M +1 -1 nepomuk/kioslaves/timeline/kio_timeline.cpp
> M +5 -5 nepomuk/services/strigi/strigiservice.cpp
>
> http://commits.kde.org/kde-runtime/d6a1cf3dfbd9f7ed5dceadc8e401451d7cebb9d4
>
> diff --git a/nepomuk/controller/systray.cpp b/nepomuk/controller/systray.cpp
> index 920877b..6cf6bc9 100644
> --- a/nepomuk/controller/systray.cpp
> +++ b/nepomuk/controller/systray.cpp
> @@ -43,7 +43,7 @@ Nepomuk::SystemTray::SystemTray( QObject* parent )
> {
> setCategory( SystemServices );
> setIconByName( "nepomuk" );
> - setTitle( i18n( "Nepomuk File Indexing" ) );
> + setTitle( i18n( "Desktop Search File Indexing" ) );
>
> // the status widget
> connect(this, SIGNAL(activateRequested(bool,QPoint)), this,
> SLOT(slotActivateRequested()));
> @@ -115,7 +115,7 @@ void Nepomuk::SystemTray::slotUpdateStrigiStatus()
> if( strigiServiceInitialized )
> statusString = m_service->userStatusString();
> else
> - statusString = i18n("Nepomuk File Indexing Service not running");
> + statusString = i18n("File indexing service not running");
> if ( statusString != m_prevStatus ) {
> m_prevStatus = statusString;
> setToolTip("nepomuk", i18n("Search Service"), statusString );
> diff --git a/nepomuk/kcm/nepomukserverkcm.cpp
> b/nepomuk/kcm/nepomukserverkcm.cpp
> index 4ae8dd8..b6bc457 100644
> --- a/nepomuk/kcm/nepomukserverkcm.cpp
> +++ b/nepomuk/kcm/nepomukserverkcm.cpp
> @@ -139,7 +139,7 @@ Nepomuk::ServerConfigModule::ServerConfigModule( QWidget*
> parent, const QVariant
> m_failedToInitialize( false )
> {
> KAboutData *about = new KAboutData(
> - "kcm_nepomuk", "kcm_nepomuk", ki18n("Nepomuk Configuration Module"),
> + "kcm_nepomuk", "kcm_nepomuk", ki18n("Desktop Search Configuration
> Module"),
> KDE_VERSION_STRING, KLocalizedString(), KAboutData::License_GPL,
> ki18n("Copyright 2007-2010 Sebastian Trüg"));
> about->addAuthor(ki18n("Sebastian Trüg"), KLocalizedString(),
> "trueg at kde.org");
> @@ -228,7 +228,7 @@ Nepomuk::ServerConfigModule::ServerConfigModule( QWidget*
> parent, const QVariant
> }
> }
> else {
> - QLabel* label = new QLabel( i18n( "The Nepomuk installation is not
> complete. No Nepomuk settings can be provided." ) );
> + QLabel* label = new QLabel( i18n( "The Nepomuk installation is not
> complete. No desktop search settings can be provided." ) );
> label->setAlignment( Qt::AlignCenter );
> QVBoxLayout* layout = new QVBoxLayout( this );
> layout->addWidget( label );
> @@ -365,9 +365,9 @@ void Nepomuk::ServerConfigModule::save()
> else if( m_checkEnableNepomuk->isChecked() ) {
> if ( !QProcess::startDetached( QLatin1String( "nepomukserver" ) ) ) {
> KMessageBox::error( this,
> - i18n( "Failed to start Nepomuk Server. The
> settings have been saved "
> + i18n( "Failed to start the desktop search
> service (Nepomuk). The settings have been saved "
> "and will be used the next time the
> server is started." ),
> - i18n( "Nepomuk server not running" ) );
> + i18n( "Desktop search service not running" )
> );
> }
> }
>
> @@ -404,10 +404,10 @@ void
> Nepomuk::ServerConfigModule::updateNepomukServerStatus()
> {
> if ( m_serverInterface &&
> m_serverInterface->isNepomukEnabled() ) {
> - m_labelNepomukStatus->setText( i18nc( "@info:status", "Nepomuk system
> is active" ) );
> + m_labelNepomukStatus->setText( i18nc( "@info:status", "Desktop search
> services are active" ) );
> }
> else {
> - m_labelNepomukStatus->setText( i18nc( "@info:status", "Nepomuk system
> is inactive" ) );
> + m_labelNepomukStatus->setText( i18nc( "@info:status", "Desktop search
> services are disabled" ) );
> }
> }
>
> @@ -429,11 +429,11 @@ void Nepomuk::ServerConfigModule::updateStrigiStatus()
> }
> else {
> m_failedToInitialize = true;
> - m_labelStrigiStatus->setText( i18nc( "@info:status", "Strigi
> service failed to initialize, most likely due to an installation problem." )
> );
> + m_labelStrigiStatus->setText( i18nc( "@info:status", "File
> indexing service failed to initialize, most likely due to an installation
> problem." ) );
> }
> }
> else if ( !m_failedToInitialize ) {
> - m_labelStrigiStatus->setText( i18nc( "@info:status", "Strigi service
> not running." ) );
> + m_labelStrigiStatus->setText( i18nc( "@info:status", "File indexing
> service not running." ) );
> }
> }
>
> diff --git a/nepomuk/kioslaves/nepomuk/kio_nepomuk.cpp
> b/nepomuk/kioslaves/nepomuk/kio_nepomuk.cpp
> index 7869337..975b3f3 100644
> --- a/nepomuk/kioslaves/nepomuk/kio_nepomuk.cpp
> +++ b/nepomuk/kioslaves/nepomuk/kio_nepomuk.cpp
> @@ -274,7 +274,7 @@ bool Nepomuk::NepomukProtocol::rewriteUrl( const KUrl&
> url, KUrl& newURL )
> bool Nepomuk::NepomukProtocol::ensureNepomukRunning()
> {
> if ( Nepomuk::ResourceManager::instance()->init() ) {
> - error( KIO::ERR_SLAVE_DEFINED, i18n( "The Nepomuk system is not
> activated. Unable to answer queries without it." ) );
> + error( KIO::ERR_SLAVE_DEFINED, i18n( "The desktop search service is
> not activated. Unable to answer queries without it." ) );
> return false;
> }
> else {
> diff --git a/nepomuk/kioslaves/search/kio_nepomuksearch.cpp
> b/nepomuk/kioslaves/search/kio_nepomuksearch.cpp
> index e68b8bc..e26dd84 100644
> --- a/nepomuk/kioslaves/search/kio_nepomuksearch.cpp
> +++ b/nepomuk/kioslaves/search/kio_nepomuksearch.cpp
> @@ -142,13 +142,13 @@ bool Nepomuk::SearchProtocol::ensureNepomukRunning( bool
> emitError )
> if ( Nepomuk::ResourceManager::instance()->init() ) {
> kDebug() << "Failed to init Nepomuk";
> if ( emitError )
> - error( KIO::ERR_SLAVE_DEFINED, i18n( "The Nepomuk system is not
> activated. Unable to answer queries without it." ) );
> + error( KIO::ERR_SLAVE_DEFINED, i18n( "The desktop search service
> is not activated. Unable to answer queries without it." ) );
> return false;
> }
> else if ( !Nepomuk::Query::QueryServiceClient::serviceAvailable() ) {
> kDebug() << "Nepomuk Query service is not running.";
> if ( emitError )
> - error( KIO::ERR_SLAVE_DEFINED, i18n( "The Nepomuk query service
> is not running. Unable to answer queries without it." ) );
> + error( KIO::ERR_SLAVE_DEFINED, i18n( "The desktop search query
> service is not running. Unable to answer queries without it." ) );
> return false;
> }
> else {
> diff --git a/nepomuk/kioslaves/timeline/kio_timeline.cpp
> b/nepomuk/kioslaves/timeline/kio_timeline.cpp
> index 9d53e68..e3f9313 100644
> --- a/nepomuk/kioslaves/timeline/kio_timeline.cpp
> +++ b/nepomuk/kioslaves/timeline/kio_timeline.cpp
> @@ -126,7 +126,7 @@ void Nepomuk::TimelineProtocol::listDir( const KUrl& url )
> "/servicecontrol",
> QDBusConnection::sessionBus()
> ).isInitialized() ) {
> error( KIO::ERR_SLAVE_DEFINED,
> - i18n( "The Nepomuk Strigi file indexing service is not
> running. Without it timeline results are not available." ) );
> + i18n( "The file indexing service is not running. Without it
> timeline results are not available." ) );
> return;
> }
>
> diff --git a/nepomuk/services/strigi/strigiservice.cpp
> b/nepomuk/services/strigi/strigiservice.cpp
> index 0189679..2b4fd12 100644
> --- a/nepomuk/services/strigi/strigiservice.cpp
> +++ b/nepomuk/services/strigi/strigiservice.cpp
> @@ -155,23 +155,23 @@ QString Nepomuk::StrigiService::userStatusString( bool
> simple ) const
> bool suspended = m_indexScheduler->isSuspended();
>
> if ( suspended ) {
> - return i18nc( "@info:status", "File indexer is suspended" );
> + return i18nc( "@info:status", "File indexer is suspended." );
> }
> else if ( indexing ) {
> QString folder = m_indexScheduler->currentFolder();
>
> if ( folder.isEmpty() || simple )
> - return i18nc( "@info:status", "Strigi is currently indexing
> files" );
> + return i18nc( "@info:status", "Indexing files for desktop
> search." );
> else {
> QString file = KUrl( m_indexScheduler->currentFile()
> ).fileName();
> if( file.isEmpty() )
> - return i18nc( "@info:status", "Strigi is currently indexing
> files in folder %1", folder );
> + return i18nc( "@info:status", "Indexing files in %1", folder
> );
> else
> - return i18nc( "@info:status", "Strigi is currently indexing
> files in folder %1 (%2)", folder, file );
> + return i18nc( "@info:status", "Indexing files in %1 (%2)",
> folder, file );
> }
> }
> else {
> - return i18nc( "@info:status", "File indexer is idle" );
> + return i18nc( "@info:status", "File indexer is idle." );
> }
> }
>
> -----------------------------------------
>
>
>
> _______________________________________________
> Nepomuk mailing list
> Nepomuk at kde.org
> https://mail.kde.org/mailman/listinfo/nepomuk
More information about the Nepomuk
mailing list