User Tools

Site Tools


start

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
start [2013-05-19 22:05]
127.0.0.1 external edit
start [2018-06-24 10:59] (current)
christian design cards
Line 1: Line 1:
 ====== Principles Wiki ====== ====== Principles Wiki ======
  
-===== The Idea =====+===== About this Wiki =====
  
-The purpose of this wiki is to collect software ​development principlesJust like common solution schemes to recurring problems are documented using patternscommon assessment rules telling good solutions from bad ones can be described using principles. So principles ​are another form of experience reuse. There are dozens ​and maybe hundreds of such principles, some of which are described, examined, discussed, and interconnected ​in this wiki.+This wiki is a place to collect, examine, and discuss ​software ​design knowledge in a systematic wayCurrently there is a strong focus on (object-oriented) design principles ([[collections:​SOLID]][[collections:​GRASP]],​ [[principles:Don't Repeat Yourself|DRY]],​ [[principles:Keep It Simple Stupid|KISS]],​ ...). In the future other forms of [[about:experience reuse]], like patterns ​and anti-patternswill also be explored ​and interconnected ​with the principles.
  
-The following pages describe the idea in more detail: 
-  * [[about:​Principles]] 
-  * [[about:​Principle Languages]] 
-  * [[about:​Benefits]] 
-  * [[about:​Using Principles in the Plan-Driven World]] 
-  * [[about:​Using Principles in the Agile World]] 
-  * [[about:​Describing Principles]] 
  
 +===== Principles and Principle Languages =====
  
-===== Principles =====+Just like common solution schemes to recurring problems are documented using [[glossary:​patterns]],​ common assessment rules telling good solutions from bad ones can be described using [[glossary:​principles]]. So principles are another form of experience reuse. There are dozens and maybe hundreds of such principles, some of which are examined here.
  
-This wiki is about [[glossary:​principles]]. You may have a look at the [[principles:|full list]] or start with one of the following: +[[collections:ood_principle_language|{{ :collections:ood_principle_language.png?​nolink&​100|}}]]
-  * [[principles:​Keep It Simple Stupid]] +
-  * [[principles:​Generalization Principle]] +
-  * [[principles:​Model Principle]] +
-  * [[principles:​Information Hiding/​Encapsulation]] +
-  * [[principles:​Low Coupling]] +
-  * [[principles:​High Cohesion]] +
-  * [[principles:​Don'​t Repeat Yourself]] +
-  * [[principles:​Easy to Use and Hard to Misuse]] +
-  * [[principles:|...]]+
  
 +[[glossary:​Principle languages]] similarly to [[glossary:​pattern languages]] interconnect principles such that the consideration of one principle inevitably leads to other principles which are likely to be relevant in the same context. Currently there is one principle language described here ([[collections:​OOD Principle Language]]) and others will follow in the future.
  
-===== Principle Collections and Principle Languages =====+([[about:​|more...]])
  
-Several related principles are grouped into [[glossary:​principle collections]] some of which form [[glossary:​principle languages]]:​ +===== Design Cards =====
-  * [[collections:​OOD Principle Language]]+
  
-  * [[collections:SOLID]], [[collections:​GRASP|GRASP]], [[collections:|...]]+[[https://​www.kickstarter.com/​projects/​designdudes/​design-cards-improving-discussions-of-software-dev?​ref=e57yvx|{{ ::​cards_in_case_small.jpg?​nolink&​250|}}]]
  
 +We are currently creating playing cards with principles. While the wiki is best for looking up principles, cards are ideal for learning them. Furthermore the cards can be used during discussions about software design. The key rule is that you can only play one card at a time. As a result you have to think about the most convincing argument to play out first. So the quality of the argument counts and not the quantity.
  
-===== Contexts =====+Have a look at our [[https://​www.kickstarter.com/​projects/​designdudes/​design-cards-improving-discussions-of-software-dev?​ref=e57yvx|Kickstarter campaign]]. It'll run until the end of July.
  
-Each principle belongs to one or more [[contexts:​]]:​+===== Principles and Design Types =====
  
-  * [[contexts:Object-Oriented Design]]+[[http://design-types.net|{{:​types_logo.png?​nolink&​100 |}}]]
  
 +The validity a a certain principles is rarely disputed. But that different developers put different weight on them. Almost no-one would claim that [[principles:​Keep It Simple Stupid|KISS]] is not a valid principle. But there are ones who think [[principles:​Generalization Principle|GP]] is more important. ​
  
-===== About the Wiki itself =====+It turns out that developers can be characterized by which principles they favor when making design decisions. Understanding these different attitudes helps in communicating about design.
  
-This [[wiki:​]] ​uses the [[wiki:dokuwiki|DokuWiki]] softwareFor information on how the wiki markup ​(some variation ​of markdown) works, see the [[wiki:syntax]] pageThe [[wiki:wish list]] lists principles that have not been described yet in this wiki.+[[http://​design-types.net|design-types.net]] describes a system of 16 design types characterizing developers in the aforementioned way. Each design type links back here to those principles each type favors or disregards. There is a questionnaire for testing yourself, a questionnaire for assessing colleagues and some statistics about those who already took part. 
 + 
 + 
 +===== Start ===== 
 + 
 +Start exploring the wiki with the [[principles:|full list of principles]]the [[collections:​OOD Principle Language]] or the [[collections:|list of (principle) collections]]. This wiki is organized in several namespaces. One for each kind of [[about:​experience reuse]] ​(principles, patterns, anti-patterns,​ ...) plus some organizational ones.  Get an overview ​of the different kinds of content in the wiki page about [[about:experience reuse]] or the [[?​do=index|sitemap]].  
 + 
 +[[wiki:contribute|Contributions]] to the wiki are welcome. Registration is not required (but appreciated). Almost all namespaces are world-editable. It's an open wiki so you are encouraged to share your knowledge.
  
-Some terms shall be used consistently throughout the wiki. The [[glossary:​]] lists and defines them:​[[glossary:​Principle]],​ [[glossary:​principle language]], [[glossary:​module]],​ [[glossary:​|...]] 
start.1368993946.txt.gz · Last modified: 2013-08-25 16:12 (external edit)