I feel it would be more frustrating to the user (who this documentation is written for if i specify :id).  I will make a code comment i guess.