diff --git a/ChangeLog b/ChangeLog
index fb9d2cccab..a0e88fbc6c 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2008-06-25  Wim Taymans  <wim.taymans@collabora.co.uk>
+
+	* docs/design/part-states.txt:
+	Fix device open/close docs.
+
 2008-06-25  Stefan Kost  <ensonic@users.sf.net>
 
 	* ChangeLog:
diff --git a/docs/design/part-states.txt b/docs/design/part-states.txt
index 38559dee97..9665818856 100644
--- a/docs/design/part-states.txt
+++ b/docs/design/part-states.txt
@@ -32,9 +32,10 @@ the following state changes are possible:
    - The element must check if the resources it needs are available.
      Device sinks and -sources typically try to probe the device to constain
      their caps.
+   - The element opens the device, this is needed if the previous step requires
+     the device to be opened.
 
  READY -> PAUSED
-   - The element opens the device and prepares itself for PLAYING.
    - the element pads are activated in order to receive data in PAUSED.
      Streaming threads are started.
    - some elements might need to return ASYNC and complete the state change
@@ -76,12 +77,13 @@ the following state changes are possible:
  PAUSED -> READY
    - sinks unblock any waits in the preroll.
    - elements unblock any waits on devices
-   - elements close devices
    - chain or get_range functions return WRONG_STATE.
    - the element pads are deactivated so that streaming becomes impossible and
      all streaming threads are stopped. 
+   - the sink forgets all negotiated formats
  
  READY -> NULL
+   - elements close devices
    - element removes any dynamically created pads