diff --git a/doc/APIchanges b/doc/APIchanges
index 18ad9dae2c5a9de4778f29dff66dbfde9e11ce77..e46c97735884d5d4f13c9b116b1da99c4d8c0da5 100644
--- a/doc/APIchanges
+++ b/doc/APIchanges
@@ -1,3 +1,17 @@
+Never assume the API of libav* to be stable unless at least 1 week has passed since
+the last major version increase.
+The last version increases were:
+libavcodec:  ?
+libavdevice: ?
+libavfilter: ?
+libavformat: ?
+libpostproc: ?
+libswscale:  ?
+libavutil:   2009-03-08
+
+
+API changes, most recent first:
+
 20090308 - r17869 - lavu 50.0.0  - AVFifoBuffer
   av_fifo_init, av_fifo_read, av_fifo_write and av_fifo_realloc were dropped and replaced
   by av_fifo_alloc, av_fifo_generic_read, av_fifo_generic_write and av_fifo_realloc2.