Theme

HU3 - Naming

Description

Participants highlighted that names in Jayvee are chosen well, especially as python function names are unclear or inconsistent.

Often, block types are mentioned meaning that users refer to elements provided by the language, not the names given to specific block instances. Without external libraries, all names in Jayvee come from a single source with a consistent style and glossary. For these reasons, a consistent naming structure from one source can improve understandability.

The names of Jayvee blocks also clearly reminded participants of steps in a data pipeline (HU2.1 - Mental model of an ETL pipeline aligns with Jayvee). By including names of domain-specific concepts, names in Jayvee are familiar to anyone who has worked with data or data pipelines before, even if they are novice programmers.

Representative Quotes

The names of the given blocks and transforms are very good, so you already get the basic meaning of every block by only reading their names.

  • S0

Code structured into blocks and self-explanatory methods and type names.

  • S12

The naming of the blocks and functions is clearly understandable even from a person that has not much programming knowledge.

  • S13

Also, I liked that Jayvee exposes the functionalities and types of every step/block through the telling clear names of the blocks and revealing the type of each step/operation.

  • S15

Names of the blocks are familiar with the concepts that usually used in the data pipelines.

  • S17

It (Jayvee) has a very structured layout with very descriptive names for the classes/objects being used.

  • S31

The pipeline was easy to understand because the blocks where organized in a way that made sense and also the naming conventions make it easy.

  • S32