Organizing your Library using tags

As your library in Digital Factory grows in size, you will find the need to start organizing it. You can use tags to classify your project into well-defined categories.

Anyone who can access to a certain project can apply or remove tags from that project. Users can choose from a list of tags that is maintained by the organization admin. The admin can maintain these directly in the Digital Factory.

Best practice for using tags

Apply multiple tags to a project

You can apply multiple tags to a project, this allows better description for your project.

For example, if your project is about designing architectures in Rotterdam, it is better to give it three tags:

  • Rotterdam
  • Architecture and
  • Design

Tag management

The tags can only be created or deleted for all projects by the administrator(s) of an organization. Below are the guidelines and tips for managing the tags.

Technical specifications for the tags

There are a few technical requirements for the tags:

  • Length: The minimum length for the tag is 1 character, and maximum length 30 characters.
  • Case-sensitive: Tags are case-sensitive, meaning that "tag" and "TAG" are two different tags.
  • Forbidden characters: Any character may be used in the tags, except the comma (,) and semicolon (;).

Tag naming conventions

1. Be concise

The rule of thumb is to name your tags in a concise way: giving a lot of information clearly in a few words, brief but comprehensive.

2. Using full-names or abbreviations

It depends on your situation: the tags can be in full name, for example "cascading style sheets", or if the abbreviation is widely accepted, you may also use "css".

3. Use our sorting of tags to your advantage

Tags in our system are sorted alphabetically. This means if you prefix your tags nicely, they will be ordered well in the tags list. You can achieve many things this way.

For example, you can add:

  • location: Geldermalsen
  • location: Utrecht
  • location: Zaltbommel

They will be shown together, which makes them better organized. This allows you to quickly organize projects based on the location they are to be used.

4. Use the same naming convention

Keeping the same naming style for tags is good for consistency and for optimal search results. It is up to the administrator to decide which naming convention the organization prefers to follow. There are several commonly used case styles, including but not limited to:

  • camelCase: thisIsMyTag
  • PascalCase: ThisIsMyTag
  • snake_case: this_is_my_tag
  • kebab-case: this-is-my-tag
  • lower case raw text: this is my tag

You may also use tags in other styles that suits your organization the best. You may create tags as the examples below:

  • priority: high
  • priority: low
  • 🐛 bug
  • 🌏 I18n
Was this article helpful?
1 out of 2 found this helpful

Comments

0 comments

Please sign in to leave a comment.