[fr] Follow #766

correct bool to boolean
[fr] Follow #771

don't advocate string urls
[fr] Follow 4d756fdb83cf69b637bcb9ebeadccc455d55be26

Add note about requiring more than just an id field.