Document differences between release and debug build configurations

[jdm]

For example:

• https://github.com/servo/servo/blob/2173b559f58495c48011de4cdb2216d14c3c03d2/ports/servoshell/Cargo.toml#L52 means debug! logs will be suppressed in a release build