[kde-doc-english] Documentation Status and Todo's for 4.11

Mon Jun 17 20:02:37 UTC 2013

Am Sonntag, 16. Juni 2013, 18:10:25 schrieb T.C. Hollingsworth:
> Readding the list since others hopefully will have comments...
> 
> On Fri, Jun 14, 2013 at 8:03 AM, Burkhard Lück <lueck at hube-lueck.de> wrote:
> > Here a list of missing gui elements from the 3.5 visual dictionary -most
> > of
> > them covered by Claus' version on userbase:
> > Button, Check Box, Color Selector, Combo Box, Context Menu, Dialog Box,
> > Drop Down Box, Icon List, List Box, Progress Bar, Radio Button, Scrollbar
> > or Scroll Bar?, Slider, Spin Box, Tab, Tabbed Window, Text Box
> 
> I've filled in the dictionary part for all these missing items now,
> except for Tabbed Window.  I'm not aware of any use of tabs that are
> not in such a configuration, so it seemed rather redundant.
> 
> I also decided to distinguish a Text Box (e.g. QLineEdit) from a Text
> Area (e.g. QTextEdit) because IMHO there are enough differences in
> appearance and behavior (e.g. what happens when you press Enter) to
> warrant distinguishing the two.
> 
Makes sense to me

> Is everyone okay with these two modifications?  Is the draft [1]
> missing any other widgets?  Please also have a look at the
> descriptions and suggest any improvements, some of them came out a
> little awkward and I'm not sure exactly how best to fix.
> 
Some minor issues:

* Reducing the width of the window leads to many line breaks in Description 
column of the table and make the text difficult to read. Could you make the 
Screenshot column  narrower ?

* Regarding the wording/spelling of the widgets (scrollbar vs scroll bar etc.) 
I have attached the file preferred_forms used on english.breakfast.org to check 
the docbooks and a statistic from stable (4,10) of all widget names and their 
spelling. Of course we should sync this spelling with ebn.

* Should we use the "The Plasma Desktop" section from  
http://userbase.kde.org/User:Claus_chr/Visual_Dictionary ?

Apart from that I am ok with your proposal.

Thanks.

-- 
Burkhard Lück
-------------- next part --------------
# Preferred forms of words for KDE user-visible strings
# Enter as:
# Deprecated form/Preferred form[/Optional comment]
# Enter one deprecated form for each possible conjugation of the word,
# including plurals and capitalizations, since we might want to enforce a
# particular capitalization (eg, for 'Internet')
# Comments must be whole line, beginning with '#'
# TODO:
# Add '<keycap>' -> '<keysym>' corrections
# NB: <keycap>Page Up</>, <keysym>Left/Right/Up/Down Arrow</> are correct
# <key(cap|sym)>Ctrl -> &Ctrl;

Addressbook/Address book
addressbook/address book
Addressbooks/Address books
addressbooks/address books

Anti alias/Anti-alias
anti alias/anti-alias
Anti aliases/Anti-aliases
anti aliases/anti-aliases
Anti aliasing/Anti-aliasing
anti aliasing/anti-aliasing

Antialias/Anti-alias
antialias/anti-alias
Antialiases/Anti-alias
antialiases/anti-alias
Antialiasing/Anti-aliasing
antialiasing/anti-aliasing

Can not/Cannot/Only use 'can not' for emphasis
can not/cannot/Only use 'can not' for emphasis
can't/cannot
Can't/Cannot

Checkbox/Check box
checkbox/check box
Checkboxes/Check boxes
checkboxes/check boxes

#Color Selector

Dropdown list/Drop down box
dropdown list/drop down box
Drop-down list/Drop down box
drop-down list/drop down box
Drop down list/Drop down box
drop down list/drop down box

Dropdown box/Drop down box
dropdown box/drop down box
Drop-down box/Drop down box
drop-down box/drop down box
Drop-down boxes/Drop down boxes
drop-down boxes/drop down boxes
Dropdown boxes/Drop down boxes
dropdown boxes/drop down boxes

#Dialog Box

Directories/Folders/Only use 'directory' for CLI
directories/folders/Only use 'directory' for CLI
Directory/Folder/Only use 'directory' for CLI
directory/folder/Only use 'directory' for CLI

E-mail/Email
e-mail/email
E-mails/Emails
e-mails/emails

File size/Filesize
file size/filesize
File sizes/Filesizes
file sizes/filesizes

Filesystem/File system
filesystem/file system
Filesystems/File systems
filesystems/file systems

Fine tune/Fine-tune
fine tune/fine-tune
Fine tunes/Fine-tunes
fine tunes/fine-tunes

Formula-bar/Formula bar
formula-bar/formula bar
Formula-bars/Formula bars
formula-bars/formula bars

Formulabar/Formula bar
formulabar/formula bar
Formulabars/Formula bars
formulabars/formula bars

Gray scale/Grayscale
gray scale/grayscale
Gray scales/Grayscales
gray scales/grayscales
Gray scaled/Grayscaled
gray scaled/grayscaled

Harddisk/Hard disk
harddisk/hard disk
Harddisks/Hard disks
harddisks/hard disks

Highscore/High score
highscore/high score
Highscores/High scores
highscores/high scores

Hit a key/Press a key
hit a key/press a key

hz/Hz

Infra-red/Infrared
infra-red/infrared
Infra-reds/Infrareds
infra-reds/infrareds

internet/Internet

it'll/it will
It'll/It will

khz/kHz

#List Box

lower case/lowercase
lower-case/lowercase
Lower case/Lowercase
Lower-case/Lowercase

Menu bar/Menubar
menu bar/menubar
Menu bars/Menubars
menu bars/menubars

Menu-bar/Menubar
menu-bar/menubar
Menu-bars/Menubars
menu-bars/menubars

Mhz/MHz
mhz/MHz/Unless you mean milliHertz...

Ok/OK
Ok/Ok

Pop-up menu/Popup menu
pop-up menu/popup menu
Pop-up menus/Popup menus
pop-up menus/popup menus

Pre-set/Preset
pre-set/preset
Pre-sets/Presets
pre-sets/presets

#Progress Bar

#Radio Button

Re start/Restart
re start/restart
Re starts/Restarts
re starts/restarts

Re-start/Restart
re-start/restart
Re-starts/Restarts
re-starts/restarts

Real time/Real-time
real time/real-time
Realtime/Real-time
realtime/real-time

Screensaver/Screen saver
screensaver/screen saver
Screensavers/Screen savers
screensavers/screen savers

#Scroll Bar

Sidebar/Navigation panel
sidebar/navigation panel
Sidebars/Navigation panels
sidebars/navigation panels

Keybinding/Shortcut
keybinding/shortcut
Keybindings/Shortcuts
keybindings/shortcuts

Key binding/Shortcut
key binding/shortcut
Key bindings/Shortcuts
key bindings/shortcuts

#Slider

Spell check/Spellcheck
spell check/spellcheck
Spell checking/Spellchecking
spell checking/spellchecking
Spell checks/Spellchecks
spell checks/spellchecks

Spell-check/Spellcheck
spell-check/spellcheck
Spell-checking/Spellchecking
spell-checking/spellchecking
Spell-checks/Spellchecks
spell-checks/spellchecks

#Spin Box

statusbar/status bar
status-bar/status bar
Statusbar/Status bar
Status-bar/Status bar

Sub process/Sub-process
sub process/sub-process
Sub processes/Sub-processes
sub processes/sub-processes

Subprocess/Sub-process
subprocess/sub-process
Subprocesses/Sub-processes
subprocesses/sub-processes

Taskmanager/Task manager
taskmanager/task manager
Taskmanagers/Task managers
taskmanagers/task managers

textbox/text box
textboxes/text boxes
text-box/text box
text-boxes/text boxes

title bar/titlebar
title-bar/titlebar
Title bar/Titlebar
Title-bar/Titlebar

Todo/To-do
todo/to-do
Todos/To-dos
todos/to-dos

Tool tip/Tooltip
tool tip/tooltip
Tool tips/Tooltips
tool tips/tooltips

Tool-tip/Tooltip
tool-tip/tooltip
Tool-tips/Tooltips
tool-tips/tooltips

tool bar/toolbar
tool-bar/toolbar
Tool bar/Toolbar
Tool-bar/Toolbar

tool bars/toolbars
tool-bars/toolbars
Tool bars/Toolbars
Tool-bars/Toolbars

treeview/tree view
Treeview/Tree view
TreeView/tree view

treeviews/tree views
Treeviews/Tree views
TreeViews/tree views

Upper case/Uppercase
upper case/uppercase
Upper-case/Uppercase
upper-case/uppercase

Webbrowser/Web browser
webbrowser/web browser
Webbrowsers/Web browsers
webbrowsers/web browsers

Webpage/Web page
webpage/web page
Webpages/Web pages
webpages/web pages

Webserver/Web server
webserver/web server
Webservers/Web servers
webservers/web servers

Whitespace/White space
whitespace/white space
Whitespaces/White spaces
whitespaces/white spaces

#Window Titlebar

# Specials

# !/!/No spacing before punctuation
# ?/?/No spacing before punctuation
, that/ that/Don't usually need comma before 'that'

'll/ will/Use contractions only in informal sections
'd/ had' or `would/Use contractions only in informal sections
've/ have/Use contractions only in informal sections

I'm/I am
i'm/I am
they're/they are
They're/They are

i.e./&ie;/Use the entity!
I.e./&ie;/Use the entity!
ie./&ie;/Use the entity!

e.g./⪚/Use the entity!
eg./⪚/Use the entity!

etc./&etc;/Use the entity!
etc/&etc;/Use the entity!

<!-- <othercredit role=/<othercredit role=/This can be uncommented when the bug is fixed

# It would be nice to check for quotes used instead of <quote>, but
# they are used legitimately in some places, so can't really check for them at this
# stage
#"/<quote>.../Should this be contained in a <quote>?

# Deprecated entities

&kcontrol;/&kcontrolcenter;/Use &kcontrol; only when you want to expand to 'KControl'
&kappname;//Use the entity for this application instead
&kmyapplication;//Use the entity for this application instead
-------------- next part --------------
docs in stable:

"[Cc]heck [bB]ox"        129
"[Cc]heck[bB]ox"         115
"[Cc]ombo [bB]ox"         61
"[Cc]ombo[bB]ox"          34

"[Cc]ontext [mM]enu"     241
"[Cc]ontext[mM]enu"        5
"[pP]opup [mM]enu"        67
"[pP]opup[mM]enu"          1

"[dD]ialog [bB]ox"       200
"[dD]ialog[bB]ox"          0

"[dD]rop [dD]own [bB]ox"  89
"[dD]rop[dD]own [bB]ox"    4
"[dD]rop[dD]own[bB]ox"     0

"[iI]con [lL]ist"          2
"[iI]con[lL]ist"           0

"[lL]ist [bB]ox"          25
"[lL]ist[bB]ox"           25

"[pP]rogress [bB]ar"      13
"[pP]rogress[bB]ar"        0

"[rR]adio [bB]utton"      40
"[rR]adio[bB]utton"        9 (kommander)

"[sS]croll [bB]ar"        10
"[sS]croll[bB]ar"         57

"[sS]pin [bB]ox"          17
"[sS]pin[bB]ox"           39

"[tT]ext [bB]ox"         204
"[tT]ext[bB]ox"            4

"[iI]nput [bB]ox"         11
"[iI]nput[bB]ox"           0
"[iI]nput [fF]ield"       32
"[iI]nput[fF]ield"         0