Differences

This shows you the differences between two versions of the page.

--- principles:uniformity_principle [2021-09-02 12:50] – old revision restored (2021-05-19 09:49) 65.21.179.175
+++ principles:uniformity_principle [2021-10-18 22:00] (current) – +++ restored +++ christian
@@ Line 24: / Line 24: @@
 Striving for consistency and always using the same solutions also means that it can be a good idea to apply a "bad" or less-well suited solution for the sake of consistency. If for example a bad naming scheme is used throughout the whole project, it is advisable not to break it as an inconsistency in the naming scheme would be worse than applying the bad naming scheme everywhere.
-For documentation UP means to have a consistent documentation structure such that a certain piece of information can be found easily.
+For documentation UP means to have a consistent documentation structure such that a certain piece of information can be found easily. Furthermore uniformity in naming schemes is especially important for documentation. When referring to the same concept the same word has to be used. Synonyms are a source of misunderstanding.
@@ Line 117: / Line 117: @@
 Discuss this wiki article and the principle on the corresponding [[talk:principles:Uniformity Principle|talk page]].