Don't pluralize single letters, symbols, or mathematical signs by adding an apostrophe and an s.

• Incorrect: Salesforce replaces unrecognizable characters with @’s.
• Correct: Salesforce replaces unrecognizable characters with the at (@) sign.

When referring to a symbol, spell out the name of the symbol and then enter the symbol in parentheses after it.

• When using an equal (=) sign, add one space on each side.
• Wrap greater-than (>) and less-than (<) signs in parentheses rather than quotation marks.

For user documentation and UI text, use the second person, you, which makes the writing more informal and personal.

• In user documentation, use the imperative voice whenever possible.

• In UI text and both user and developer documentation, you or the imperative is almost always appropriate in procedures, since the person reading the documentation is usually the same person trying to perform the task. For example:

  
  

  
  

  • Select the Tag checkbox to enable tagging.
  • Download library resources from the Alexandria website.

• Omit You can when possible as it unnecessarily increases word count.

• Use the third person when the information isn't directed at a specific user, though this sometimes means using the passive voice. For example: If this header isn't used or the value of its element is null, the opportunities are transferred to the forecast manager in the specified territory.

• Be aware of the various, possible contexts for the information. Some text is extremely sensitive to context, and procedures or explanations of how a feature or component works must be written with different user contexts in mind. This is because the person reading the documentation is most likely not the one issuing the command or method under discussion. Developers may read information that they need to know to write a client program that actually executes the command, so phrases like you or your organization aren't always right.

Avoid if possible by rephrasing your content into shorter, simpler sentences. If needed, a semicolon can be used to:

• Separate coordinate clauses that contain commas
• Separate a lengthy or complex series
• Precede then when used transitionally between clauses of a compound sentence. Avoid these other overly formal conjunctive adjectives: therefore, likewise, consequently, and accordingly.
• Separate clauses of a compound sentence that are very long or are themselves subdivided by commas.
• Separate items in a series that are long and complex.

Place semicolons and colons outside quotation marks and parentheses.

Setup is a noun or an adjective. Set up is a verb phrase.

• Setup: noun or adjective used when referring to computers and their setup
• Go to the setup screen. [adjective]
• This PC's setup is rather odd. [noun]

• Set-up:  noun  'the set-up'
• It was a complete set-up from start to end!
• The set-up of this children’s climbing frame is so tricky.

• Set-up: adjective that refers to things which are NOT referring to computers and their setup
• The bank account attracted a $10 set-up fee.
• The set-up time was extremely short.

• Set up: verb 'to set up'
• You must set up your computer.
• To set up your stall now would be most wise.
• He was told lies and was completely set up.

Sign up is a verb. Sign-up is an adjective or noun. Don't use signup. 

For example:

• When you sign up, choose your template.
• During sign-up, choose your template.
• The sign-up process is easy.

• Avoid using slashes (/). In most instances, a slash means or, so use or instead.
• It's acceptable to use slashes in the names of system components, software packages, and so on when appropriate. Also, be especially aware that, in many cases, slashes may be parts of commands or instructions that are essential to perform the task.

• Insert a space between a number and any multiple-letter abbreviation or unit symbol it modifies: 120 MB
• Omit a space between a number and a single-letter abbreviation or unit symbol: 90%, 401(k)
• When a measurement is used as an adjective, use a hyphen to connect the number to the measurement, as in 10-point type. Otherwise, don't use a hyphen.

Don't capitalize in general usage. For example, it would be "Payments subtab" instead of "Payments Subtab."

Use sentence case capitalization for subtab names.

Use support representative to refer to a customer support user. Don't use rep, support rep, customer support representative, support agent, or customer support agent.

Use sync instead of synchronize or synchronization in general use. You can also use resync.

The following terms are related to whether transactions in a group are executed one at a time (synchronous) or at the same or overlapping times (asynchronous). Spell them out:

• asynchronous
• asynchronously
• synchronous

The proper term to use when describing an action involving choosing an option from a dropdown menu, a radio button selection, or a checkbox. “Check” is not correct.

Things customers purchase from us, such as training, Cloud-Hosted services, technical support services. It can also be used as a technical term relating to the capabilities of the server and how its clients initiate server operations.

A site is an individual library or school.

Site preferences are local and only affect one database.

Site ID is the official term as of 20220310. Not Site ID Code, or Site Code. You can call it a site code though.

SIF ensures that K-12 instructional and administrative software applications work together more effectively. It reduces the redundancy of data entry and allows data to be efficiently exchanged among different applications using a standard set of specifications.

SIP2 allows you to utilize SIP2 hardware (e.g. Checkpoint, 3M, etc.) by supporting the SIP2 protocol. Make your library more efficient with enhanced inventory and security features. Empower your patrons with self-service check-in and check-out modes, allowing you more time to focus on patron information needs.

global; things that affect more than 1 database

They should always be considered System Patrons; being “special” has too many unfavorable connotations.

Self Hosted (previously Alexandria Customer-Managed, then Self-Hosted)

When customers purchase Self Hosted (On-Premises) and various Alexandria licenses, they are responsible to install, define DNS access, update, and backup themselves. In other words, customers must manage their own installation and operations.

As opposed to Cloud Hosted where we manage their data.

Self Hosted should be used without a hyphen, except as a descriptor e.g. "your self-hosted servers".

Snackbars inform users of actions the app has performed or will perform. They appear temporarily at the bottom of the screen.

The sidenav is the navigation menu on the left side of the screen. It contains links to major modules/areas and displays randomized app tips at the bottom. It can be collapsed or expanded.

Groupings of information within Details pane tabs. These are primarily found in Patrons Management and Items Management.

A dropdown menu that allows the user to specify how results or information is sorted. Patrons and Items Management each have a Sort dropdown above the Record List.

A button that allows users to choose between a descending or ascending sort order for the Patrons/Items Management Record List's results. It's located above the Record List and is represented by an icon consisting of an A, Z, and arrow.

Settings are lower-level sets of individual preferences; they are not usually used site-wide. These include Self-Service and Activity station settings, Patron Status avatars, and operator account settings.