add recommendations to /dev doc