Hi,

although detailed descriptions is a good thing, my recent experiences with web
clients for RESTCONF indicate that they can become clumsy and unwieldy in such
user interfaces. I think it would be useful to adopt a convention similar to Git
commit messages: one relatively short summary line followed by an empty line,
and the rest of the description after that. User interfaces could then easily
recognize and use the summary line.

Perhaps 6087bis could include such a recommendation.

Lada

-- 
Ladislav Lhotka
Head, CZ.NIC Labs
PGP Key ID: 0xB8F92B08A9F76C67

_______________________________________________
netmod mailing list
[email protected]
https://www.ietf.org/mailman/listinfo/netmod

Reply via email to