Loading...
 
Skip to main content

Unification of terms, better parameter naming consistency (Name vs Title vs Caption vs Label)

Status
Open
Subject
Unification of terms, better parameter naming consistency (Name vs Title vs Caption vs Label)
Version
master
Category
  • Feature request
Feature
UI / UX (User interface and experience)
Resolution status
New
Submitted by
Bernard Sfez / Tiki Specialist
Volunteered to solve
Adrien
Lastmod by
Bernard Sfez / Tiki Specialist
Rating
(0)
Description

In Tiki23 (and more) we have different name for what appears in the user name the same thing. (bolder if he is not English mother tongue)

This parameter is a caption
Copy to clipboard
Caption

Name
This parameter is a label

Etc... You understand the idea. Sometimes it may be different WITHIN the tool usage (one word in the Admin area, another on the wiki page, etc).

I don't want to argue about what do what and improve the exact terminology of things.
I want to improve the user experience by using consistent parameters so he feel less confused (Tiki is confusing... ?)

So when the user (not necessarily Admins) edit a page and add a plugin directly he doesn't have to look the doc to know if he should use; caption, label, name or title.

We may end with some "specificities" due to the real usage but it have to stop to be a Russian roulette. 😉

Solution

This is wide but not that complicate in the end.
First task is to create a wiki page and establish list of terms used per area, check the term used and dress a list.

IE:

  1. Wiki-plugin

Plugin | Parameter name | Proposed
Code | Caption | Title
Fade | Label | Title

... | ...
#Modules
... | ...
# Features
... | ... ||


Etc...
Then we will ask our "linguist specialist" 😉 to help us with naming the things.

To make it simple, let's start with the plugins (a rather simple case) and then we will have better experience on how to progress with the other areas.

Importance
7
Easy to solve?
7
Priority
49
Demonstrate Bug on Tiki 19+
Demonstrate Bug (older Tiki versions)
Ticket ID
7974
Created
Thursday 09 December, 2021 06:24:18 UTC
by Bernard Sfez / Tiki Specialist
LastModif
Thursday 09 December, 2021 06:35:08 UTC


Show PHP error messages