Vocabulary

In an effort to try and make internal names and the interface consistent, here are some style guidelines we've been using and some de facto ones I've noticed. The GNOME Style Guide should also be followed.

• Both a metadata key/value pair, and the whole set of them for a file, is called a tag, not a comment.
• A song list is any list of songs. A play list is the list of songs in the main window. A playlist is something made in the Playlists browser, or an M3U/PLS file.
• A song list is divided into columns, not headers.
• A browser is something that lets you construct a song list. They are selected in the View or Browse Library menus.
• The currently playing song is called the playing song, not the "current song".
• A search is any text entry that searches the library. A query is a search in the Search Library browser.
• Folder, not directory. (Except we use directory a translation of ~dirname.)
• Songs rather than files, except when doing something with the file system.
• Library, not audio library unless you need to disambiguate. Your library, not the library.
• Message primary text should be in the form of:
  • Actions: Verbing noun
  • Failures: Unable to verb noun
  • Confirmations: Verb noun?
• Prompts (Enter a location:) end with colons, not full stops.
• Queue, not play queue (what else would it queue?) except to avoid potential collisions with Queue.Queue (so the class remains PlayQueue).

Because I always lose it, HIG text label standards.