On 3/20/2017 9:22 AM, Issei Nishigata wrote:
Hand-editing is perfectly acceptable if it is done right. The reason
that editing is discouraged is because mixing it with API usage can
result in hand edits getting lost.
The online Schema API reference now includes a note about why
hand-editing is discouraged. The managed-schema comment could include a
link to that.