Element Naming: Character Length
This product will be viewed on many different devices and screen-sizes. To ensure readability we recommend a maximum length of 48 characters (including spaces) for any Strand, Topic or Concept name.
The exact name used in the curriculum authoring tool will be displayed in the final product for your users, so please do not add any extra information or metadata which should not be displayed to your users, for example:
(i) the author has included the # of desired questions in the actual concept name in brackets. (Note: If it is a requirement to display the number of questions to your users, we will handle this through the interface, not in the curriculum tool itself.)
(ii) the following topic, which has too many characters, would be displayed to your users as:
Element Naming: Consistency
It is likely that you will have different authors working on different content at the same time, so it’s important to be consistent in the naming and maintain version control.
Let’s assume that you want to split a large topic (Coordinate Geometry) into two topics. You could represent this as:
Coordinate Geometry 1 & Coordinate Geometry 2, or,
Coordinate Geometry i & Coordinate Geometry ii, or,
Coordinate Geometry A & Coordinate Geometry B, or,
Introduction to Coordinate Geometry & More Difficult Coordinate Geometry, or,
Simple Coordinate Geometry & Advanced Coordinate Geometry.
Similarly, you may have a single topic that combines two ideas. You could represent this as:
Statistics and Probability, or,
Statistics & Probability, or,
Statistics / Probability.
Whatever naming convention you decide, it’s important to make sure it’s consistent across the product.
As with any complex project with multiple contributors, the naming conventions and version control of these names is extremely important.
A typical Maths Product may contain 5 Strand Names, 32 Topic Names and 132 Concept Names. With 169 different elements, the project can quickly become confusing if different documents use different names or conventions. The naming conventions are best documented in a Style Guide.