Distinguish Between Different Kinds of Paths Where Applicable [VD15]
Distinguish Between Different Kinds of Paths Where Applicable [VD15]
Tip VD15
There are many different kinds of paths, with “relative” and “absolute” paths being the most common. If those distinctions are important, clarify variables names with terms like relative_path
and absolute_path
so a programmer will know what kind of data is expected.
If any kind of path is acceptable, then just a path
suffix can often work with documentation to provide additional details.
The following examples of function signatures demonstrate the distinctions:
, multiple selections available,