JDOC:Words to watch

Revision as of 15:54, 21 November 2010

Words to Watch are words commonly misspelled or which may have variations that depend on the Joomla! style guide choices.

An entry, which is just a word without a comment, is to show how we are spelling that word.

If an entry has something rather than something else then it should be read as, "We are using the spelling of the first something rather than the other possible spellings shown in something else".

Accepted Word	Unacceptable Word	Detail
accessory		Spell with a double c and a double s; the ending is -ory.
accommodate		Spell with a double c and a double m and an o before and after the m's.
Administrator	administrator	Always capitalise when referring to the Joomla user level or the backend Administrator. (Use of the latter should be limited to avoid confusion. Refer to this area as the Control Panel when referring to the facilities and backend when comparing to the frontend.
address		Spell with a double d.
aggression		Remember to spell with a double g and a double s.
allege		Use a double l and spell with -ege at the end.
a lot	alot	Use as two words, not one.
amend and amendment		Spell with a single m at the beginning.
apologize or apologise		Spell with -olo- in the middle.
apparent		Use double p but only one r and end in -ent.
argument		Do not put an e after the u, as you would in argue.
Article		Do not capitalise the word article when referring to the element of Joomla content, but capitalise it when referring to the Article Manager.
AutoCorrect		One word with capitalisation as shown
backend	Backend or Back-end	Ensure it is never capitalised and never hyphenated when referring to the Administrator area of Joomla.
backup and back up		Use backup when used as an adjective, as in "he had a backup disk in his bag" or as a noun, as in "he saved a backup." Use back up when using it as a verb, as in "don’t forget to back up your hard drive".
Banner		Do not capitalise the word banner when referring to the element of Joomla content, but capitalise it when referring to the Banner Manager.
bitmap	bit map or bit-map	One word, not hyphenated or two words.
business	bisiness, biznes	Spell with busi- at the beginning
Category (Manager)		Do not capitalise the word category when referring to the element of Joomla content, but capitalise it when referring to the Category Manager.
command	comand
Contact (Manager)		Always capitalise when referring to the Contact Manager in Joomla.
checkbox	check box
check-in (noun/adjective) (Global) Check-in	checkin (noun/adjective)	Use check-in, which must be capitalised when referring to a specific function, menu Item, or button such as the Global Check-in. It is correct to use check in (verb) as in "check in your materials".
Component (Manager)		Capitalise the word Component when referring to the Component Manager in Joomla.
consensus and consensual	concensus	Spell with -sen- in the middle.
Contact		Capitalise the word Contact when referring to the Contact Component.
Control Panel	control panel	Capitalise when referring to the Joomla backend functional area.
controversy	contraversy
CSS	css	Always capitalise except in code or when used as a file extension.
database	data base	One word, not two.
desperate	desparate	Spell desperate with -per- in the middle.
dial-up	dialup dial up	Include the hyphen between "dial" and "up."
disappoint and disappointment	dissapoint disapoint dissappoint	Remember to spell with one s and a double p.
eighth	eigth	Remember to use -hth at the end.
email	E-mail email	Email is obviously correct at the start of a sentence! Use email (lowercase and no hyphen) for consistency.
extension(s)	Extension(s)	Refer to components, modules, and plug-ins collectively as extensions. Always capitalise when referring to the Extension Manager.
embarrass	embbaras	Spell with a single b, double r, and a double s.
extraordinary	extrordinary	Do not omit the “a” of extra.
fascinate and fascination	facination	Spell with an s before the c.
file name	filename	Two words rather than one.
friend		Spell with -ie- in the middle.
frontend	Front-end, front-end	Ensure it is never capitalised and not hyphenated when referring to the user (public) area of Joomla.
Front Page front page	Frontpage frontpage	Always two words. Capitalise the words Front Page when referring to the menu Item element of Joomla content.
fulfil	fulfill	Spell with one l in the middle and one at the end
gateway	gate way	One word, not two.
gauge	gage	Spell with -au- in the middle.
grateful	gratful or graitful	Begin with grate-. Single ‘l’ at the end
harass and harassment	harrass and harrassment	Spell with a single r and a double s.
hard disk	hard-disk	Two words. No hyphenation
hardware	hard-ware	One word. No hyphenation
home page	homepage	Always two words.
HTML	HTM html	Always capitalise, except in code or when a file extension.
hypocrisy	hypocrasy hypocrisey	Begin with hypo- and end with -isy.
immediate and immediacy	imediate	Spell with a double m.
independent	independant	End with –ent rather than -ant.
instalment	installment	Spell with one l
itinerary	itinery	End with -erary.
JavaScript	javascript Java Script	One word but with the J and S capitalised.
Joomla!	joomla, Joomla,	Always capitalise and include the exclamation mark on the first usage on a page (usually a title). Otherwise, like in code, capitalise and don't include the exclamation mark.
joomla_root/		Use as the starting point to all references to directories within the core installation to avoid confusion with the web server or database root.
keyboard	key board	One word not two
licence and license		Use licence as a noun for the permit you obtain to do something like hunt or drive, but use license when you mean it as a verb, to give permission to or allow someone to do something or for something to occur.
login, logon, logoff, and logout		Noun: always one word, one “g”, the act of logging into or out of a computer or Web site. Also, used to refer to the username used to log in, as in "he used his login and password to access the site."
log in, log on, and log off log out		Verb to go through the procedure of logging in to or out of a Web site, as in "he logged in to the password protected area."
maintenance	maintainence	Spell with -ten- in the middle and end with -ance.
mambot	Mambot	Never capitalise when used for a Joomla extension. Remember, in Joomla 1.5 this is replaced by plug-in.
Manager	manager	When referring to either the user level or a manager screen (Poll Manager) it is capitalised.
manoeuvre	maneuver	Spell with -oeu- in the middle and -vre at end
Media Manager	media manager	Capitalise when referring to the Joomla extension.
menu	Menu	Never capitalise when referring to a specific menu, except when used as the Menu Manager.
menu item	Menu Item	Two words and never capitalise both when referring to the specific element within Joomla, except when referring to the Menu Item Manager.
metadata	meta data	One word
millennium		Spell with a double l and a double n.
minuscule		Spell with a u after the n.
misspell	mispell	Spell with a double s.
module	Module	Never capitalise when used for a Joomla extension, but capitalise when used in the Module Manager.
multitasking	multi-tasking multi tasking	one word
MySQL	mysql MYSQL
News Feed (Manager), news feed	newsfeed Newsfeed	Always capitalise when referring to the Joomla component and always two words. Use lowercase when referring to a news feed item itself.
necessary and necessity	neccessary	Spelled with one c and a double s.
occasion	occassion	Spell with a double c and a single s.
OK	Ok, ok	capitalise both letters
omission	ommission	Spell with one m and a double s.
online	on-line on line	One word
open source	Open Source (OS)	Never capitalise the O and S unless used in a proper name.
original		Spell with an i before and after the g.
overwrite	over write over-write	One word
password	pass word	One word
PHP	php	Always capitalise except when used as a file extension or in code.
Poll (Manager)	poll manager	Always capitalise when referring to the Joomla component.
platform
Plug-in, plug-in	plugin, Plugin	Two words, hyphenated. Never capitalise except when referring to the Plug-in Manager.
possess and possession	posess	Spell with a double s before and after the e.
PostScript	Post Script post-script	One word. Capitalise P and S.
practice and practise		Use practice as a noun when describing actually doing something rather than just discussing it or theories about it, as in “put your good manners into practice”. Use practise as the verb, “improving your skill by doing something over and over.”
presence	presance	End with -ence.
privilege	privilage privildge	Spell with -ege at the end.
proofread	proof-read, proofed, proof read	This applies to all derivatives as well, such as proofreader, proofreading, etc.
questionnaire	questionare	Spell with a double n and end with -aire.
really	realy	Spell with a double l in the middle.
receive	recieve	Use i before e except after c.
recommend and recommendation	reccomend	Spell with a single c and a double m.
restaurant	restorant restaront	Spell with -au- between the t and r.
rhythm	writhm
secretary	secratary secretery	Use an e after the r and end with -ary.
section	Section	Never capitalise when referring to the specific element within Joomla, but capitalize when referring to the Section Manager.
seize	sieze	Spell with the e before the i.
separate	seperate	Spell with -par- in the middle.
similar	simalar simillar similer	End with –lar rather than -ler.
skilful, skilfully, skilfulness	skillfull	Watch for variations as shown
software	soft ware soft-ware	One word.
source code	sourcecode	Two words.
style sheet	stylesheet style-sheet	Two words, no hyphen.
subdirectory	sub-directory sub directory	One word
subdocument	sub-document sub document	One word
success and successful	sucess	Spell with a double c and a double s.
sufficient	suficient	Use a double f in the middle and end with -cient.
Super Administrator	super administrator	Always capitalise when referring to the Joomla user level.
surprise		Spell with an r before and after the p.
tomorrow		Spell with a single m and a double r.
toolbar	tool bar tool-bar	One word
twelfth	twelth	Spell with an f in the middle.
unfortunately		Spell with -ately at the end.
until		Use a single l at the end.
URL	Url url	Capitalise except when used in code.
user	User	When referring to a specific Joomla user, never capitalise the first letter, except when referring to the User Manager.
vehicle		Spell with -icle at the end.
Web	web	Capitalise except when using to refer to a spider's trap.
Web link Web Link	weblink web-link	Two words, unhyphenated. Capitalise both words when referring to the Web Link Manager.
website	Web site Web Site web site	Formerly, the Web was used as a proper noun, but common usage of the term websites has changed and it is commonly accepted by the Chicago Manual of Style and the AP Stylebook.
weird	wierd	Spell with the e before the i
wilful	willfull willful	Only use a single l in the middle, and one at the end.
withhold	withold	Spell with a double h in the middle.
World Wide Web (WWW)	Worldwide Web	Capitalise, as it is a proper noun. Three separate words. Capitalise the abbreviation except in URLs.

This Words to Watch list was adapted from the Joomla! Editorial Style Guide v1.0.5 and is reproduced here for convenience.

This page is licensed under the Creative Commons Attribution NonCommercial ShareAlike 3.0 License

JDOC:Words to watch

Revision as of 15:54, 21 November 2010

Personal tools

Namespaces

Variants

Views

Actions

Search

Navigation

Joomla! Sites

Toolbox

@@ Line 22: / Line 22: @@
 |Administrator
 |administrator
-|Always capitalise when referring to the Joomla! User level or the Back-end Administrator. (Use of the latter should be limited to avoid confusion. Refer to this area as the Control Panel when referring to the facilities and Back-end when comparing to the Front-end.
+|Always capitalise when referring to the Joomla user level or the backend Administrator. (Use of the latter should be limited to avoid confusion. Refer to this area as the Control Panel when referring to the facilities and backend when comparing to the frontend.
 |-
 |address
@@ Line 58: / Line 58: @@
 |Article
 |
-|Capitalise the word Article when referring to the element of Joomla! content.
+|Do not capitalise the word article when referring to the element of Joomla content, but capitalise it when referring to the Article Manager.
 |-
 |AutoCorrect
@@ Line 64: / Line 64: @@
 |One word with capitalisation as shown
 |-
-|Back-end
 |backend
-|Ensure it is always capitalised and hyphenated when referring to the Administrator area of Joomla!
+|Backend or Back-end
+|Ensure it is never capitalised and never hyphenated when referring to the Administrator area of Joomla.
 |-
 |backup and back up
 |
-|Use backup when used as an adjective, as in "he had a backup disk in his bag" and use back up when using it as a verb, as in "don’t forget to back up your hard drive".
+|Use backup when used as an adjective, as in "he had a backup disk in his bag" or as a noun, as in "he saved a backup." Use back up when using it as a verb, as in "don’t forget to back up your hard drive".
 |-
 |Banner
 |
-|Capitalise the word Banner when referring to the element of the Joomla! Banner Component.
+|Do not capitalise the word banner when referring to the element of Joomla content, but capitalise it when referring to the Banner Manager.
 |-
 |bitmap
 |bit map or bit-map
-|One word not hyphenated or two words.
+|One word, not hyphenated or two words.
 |-
 |business
-|bisiness
+|bisiness, biznes
 |Spell with busi- at the beginning
 |-
 |Category (Manager)
 |
-|Capitalise the word Category when referring to the element of Joomla! content.
+|Do not capitalise the word category when referring to the element of Joomla content, but capitalise it when referring to the Category Manager.
 |-
 |command
@@ Line 94: / Line 94: @@
 |Contact (Manager)
 |
-|Always capitalise when referring to the Component element or Manager function.
+|Always capitalise when referring to the Contact Manager in Joomla.
 |-
 |checkbox
@@ Line 102: / Line 102: @@
 |check-in (noun/adjective) (Global) Check-in
 |checkin (noun/adjective)
-|We will be using check-in, which must be capitalised when referring to a specific function, Menu Item, or button such as Global Check-in. It is correct to use check in (verb) as in "check in your materials".
+|Use check-in, which must be capitalised when referring to a specific function, menu Item, or button such as the Global Check-in. It is correct to use check in (verb) as in "check in your materials".
 |-
 |Component (Manager)
 |
-|Capitalise the word Component when referring to an Extension in Joomla!.
+|Capitalise the word Component when referring to the Component Manager in Joomla.
 |-
 |consensus and consensual
@@ Line 114: / Line 114: @@
 |Contact
 |
-|Capitalise the word Contact when referring to the element of the Joomla! Contact Component.
+|Capitalise the word Contact when referring to the Contact Component.
 |-
 |Control Panel
 |control panel
-|Capitalise when referring to the Joomla! Back-end functional area.
+|Capitalise when referring to the Joomla backend functional area.
 |-
 |controversy
@@ Line 126: / Line 126: @@
 |CSS
 |css
-|Always capitalise except in code or when a file extension.
+|Always capitalise except in code or when used as a file extension.
 |-
 |database
 |data base
-|One word not two
+|One word, not two.
 |-
 |desperate
@@ Line 138: / Line 138: @@
 |dial-up
 |dialup dial up
-|Include the hyphen between "dial" and "up".
+|Include the hyphen between "dial" and "up."
 |-
 |disappoint and disappointment
@@ Line 148: / Line 148: @@
 |Remember to use -hth at the end.
 |-
-|e-mail
+|email
 |E-mail email
-|E-mail is obviously correct at the start of a sentence!  We will be going with e-mail (lower-case and hyphenated) for consistency.
+|Email is obviously correct at the start of a sentence!  Use email (lowercase and no hyphen) for consistency.
 |-
-|Extension(s)
 |extension(s)
-|Refer to Components, Modules, and Plugins collectively as Extensions. Always capitalise when referring to CMPT’s
+|Extension(s)
+|Refer to components, modules, and plug-ins collectively as extensions. Always capitalise when referring to the Extension Manager.
 |-
 |embarrass
@@ Line 176: / Line 176: @@
 |Spell with -ie- in the middle.
 |-
-|Front-end
 |frontend
-|Ensure it is always capitalised and hyphenated when referring to the User (public) area of Joomla!
+|Front-end, front-end
+|Ensure it is never capitalised and not hyphenated when referring to the user (public) area of Joomla.
 |-
 |Front Page front page
 |Frontpage frontpage
-|Always two words. Capitalise the words Front Page when referring to the Menu Item element of Joomla! content.
+|Always two words. Capitalise the words Front Page when referring to the menu Item element of Joomla content.
 |-
 |fulfil
@@ Line 246: / Line 246: @@
 |Joomla!
 |joomla, Joomla,
-|Always capitalise and include the exclamation mark every time except in code.
+|Always capitalise and include the exclamation mark on the first usage on a page (usually a title). Otherwise, like in code, capitalise and don't include the exclamation mark.
 |-
 |joomla_root/
@@ Line 262: / Line 262: @@
 |login, logon, logoff, and logout
 |
-|Noun always one word one “g” the act of logging into or out of a computer or Web site.
+|Noun: always one word, one “g”, the act of logging into or out of a computer or Web site. Also, used to refer to the username used to log in, as in "he used his login and password to access the site."
 |-
 |log in, log on, and log off log out
 |
-|Verb to go through the procedure of logging in to or out of a Web site for example
+|Verb to go through the procedure of logging in to or out of a Web site, as in "he logged in to the password protected area."
 |-
 |maintenance
@@ Line 272: / Line 272: @@
 |Spell with -ten- in the middle and end with -ance.
 |-
+|mambot
 |Mambot
-|mambot
+|Never capitalise when used for a Joomla extension. Remember, in Joomla 1.5 this is replaced by plug-in.
-|Always capitalise when used for a Joomla! Extension. Remember from 1.5 this is replaced by Plugin.
 |-
 |Manager
 |manager
-|When referring to either the User level or a Manager screen (Poll Manager) it is capitalised.
+|When referring to either the user level or a manager screen (Poll Manager) it is capitalised.
 |-
 |manoeuvre
@@ Line 286: / Line 286: @@
 |Media Manager
 |media manager
-|Capitalise when referring to the Joomla! function.
+|Capitalise when referring to the Joomla extension.
 |-
-|Menu
 |menu
-|When referring to a specific menu in Joomla! always capitalise.
+|Menu
+|Never capitalise when referring to a specific menu, except when used as the Menu Manager.
 |-
-|Menu Item
 |menu item
-|Two words and capitalise both when referring to the specific element within Joomla! but not when generally discussing any old menu items
+|Menu Item
+|Two words and never capitalise both when referring to the specific element within Joomla, except when referring to the Menu Item Manager.
 |-
 |metadata
@@ Line 312: / Line 312: @@
 |Spell with a double s.
 |-
-|Module
 |module
-|Always capitalise when used for a Joomla! Extension.
+|Module
+|Never capitalise when used for a Joomla extension, but capitalise when used in the Module Manager.
 |-
 |multitasking
@@ Line 324: / Line 324: @@
 |
 |-
-|News Feed (Manager)
+|News Feed (Manager), news feed
 |newsfeed Newsfeed
-|Always capitalise when referring to the Component within Joomla!, and always two words. Manager when included is always capitalised
+|Always capitalise when referring to the Joomla component and always two words. Use lowercase when referring to a news feed item itself.
 |-
 |necessary and necessity
@@ Line 348: / Line 348: @@
 |One word
 |-
-|Open Source (OS)
 |open source
-|Capitalise the O and S.
+|Open Source (OS)
+|Never capitalise the O and S unless used in a proper name.
 |-
 |original
@@ Line 366: / Line 366: @@
 |PHP
 |php
-|Always capitalise except when used as a file extension or in code
+|Always capitalise except when used as a file extension or in code.
 |-
 |Poll (Manager)
 |poll manager
-|Always capitalise when referring to the Component in Joomla!.
+|Always capitalise when referring to the Joomla component.
 |-
 |platform
@@ Line 376: / Line 376: @@
 |
 |-
-|Plugin(s)
+|Plug-in, plug-in
-|
+|plugin, Plugin
-|One word, always capitalise when referring to the Extension.
+|Two words, hyphenated. Never capitalise except when referring to the Plug-in Manager.
 |-
 |possess and possession
@@ Line 390: / Line 390: @@
 |practice and practise
 |
-|Use practice as a noun when describing actually doing something rather than just discussing it or theories about it, as in “put your good manners into practice”. Use practise as the verb, “improving your skill by doing something over and over”.
+|Use practice as a noun when describing actually doing something rather than just discussing it or theories about it, as in “put your good manners into practice”. Use practise as the verb, “improving your skill by doing something over and over.”
 |-
 |presence
@@ Line 432: / Line 432: @@
 |Use an e after the r and end with -ary.
 |-
-|Section
 |section
-|Always capitalise when referring to the specific element within Joomla! cms.
+|Section
+|Never capitalise when referring to the specific element within Joomla, but capitalize when referring to the Section Manager.
 |-
 |seize
@@ Line 454: / Line 454: @@
 |software
 |soft ware soft-ware
-|One word
+|One word.
 |-
 |source code
 |sourcecode
-|Two words
+|Two words.
 |-
 |style sheet
 |stylesheet style-sheet
-|Two words no hyphen
+|Two words, no hyphen.
 |-
 |subdirectory
@@ Line 482: / Line 482: @@
 |Super Administrator
 |super administrator
-|Always capitalise when referring to the Joomla! User level.
+|Always capitalise when referring to the Joomla user level.
 |-
 |surprise
@@ Line 512: / Line 512: @@
 |Capitalise except when used in code.
 |-
-|User
 |user
-|When referring to a specific Joomla! User always capitalise first letter
+|User
+|When referring to a specific Joomla user, never capitalise the first letter, except when referring to the User Manager.
 |-
 |vehicle
@@ Line 522: / Line 522: @@
 |Web
 |web
-|Capitalise except when using to refer to a spiders trap!
+|Capitalise except when using to refer to a spider's trap.
 |-
 |Web link Web Link
 |weblink web-link
-|Two words unhyphenated. Capitalise the words when discussing the Component variant - Web Link Manager.
+|Two words, unhyphenated. Capitalise both words when referring to the Web Link Manager.
 |-
-|Web site
+|website
-|website Web Site web site
+|Web site Web Site web site
-|As the World Wide Web is a proper noun, we use initial upper-case letter, in the same way as you do with your surname. This is a change. Site however is lower case.
+|Formerly, the Web was used as a proper noun, but common usage of the term websites has changed and it is commonly accepted by the Chicago Manual of Style and the AP Stylebook.
 |-
 |weird
@@ Line 546: / Line 546: @@
 |World Wide Web (WWW)
 |Worldwide Web
-|Capitalise, as it is a proper noun. Three separate words. Capitalise the abbreviation (except in URL’s)
+|Capitalise, as it is a proper noun. Three separate words. Capitalise the abbreviation except in URLs.
 |}