[MRG] updated AMI documentation

Fix #2868.