<font size=2 face="sans-serif">To add to the growing pains of keystone-specs,
one thing I've noticed is, there is inconsistency in the 'REST API Impact'
section.</font>
<br>
<br><font size=2 face="sans-serif">To be clear here, I don't mean we shouldn't
include what new APIs will be created, I think that is essential. But rather,
remove the need to specifically spell out the request and response blocks.</font>
<br>
<br><font size=2 face="sans-serif">Personally, I find it redundant for
a few reasons:</font>
<br>
<br><font size=2 face="sans-serif">1) We already have identity-api, which
will need to be updated once the spec is completed anyway.</font>
<br><font size=2 face="sans-serif">2) It's easy to get bogged down in the
spec review as it is, I don't want to have to point out mistakes in the
request/response blocks too (as I'll need to do that when reviewing the
identity-api patch anyway).</font>
<br><font size=2 face="sans-serif">3) Come time to propose the identity-api
patch, there might be differences in what was proposed in the spec.</font>
<br>
<br><font size=2 face="sans-serif">Personally I'd be OK with just stating
the HTTP method and the endpoint. Thoughts?</font>
<br>
<br><font size=2 face="sans-serif">Many apologies in advance for my pedantic-ness!<br>
</font>
<br><font size=1 face="Arial">Regards,</font>
<br>
<br><font size=3 color=#8f8f8f face="Arial"><b>Steve Martinelli</b></font><font size=1 face="Arial"><br>
Software Developer - Openstack<br>
Keystone Core Member</font>
<table width=680 style="border-collapse:collapse;">
<tr height=8>
<td width=680 colspan=2 style="border-style:solid;border-color:#000000;border-width:0px 0px 0px 0px;padding:0px 0px;">
<hr>
<tr valign=top height=8>
<td width=420 style="border-style:solid;border-color:#000000;border-width:0px 0px 0px 0px;padding:0px 0px;"><font size=1 color=#4181c0 face="Arial"><b>Phone:</b></font><font size=1 color=#5f5f5f face="Arial">
1-905-413-2851</font><font size=1 color=#4181c0 face="Arial"><b><br>
E-mail:</b></font><font size=1 color=#5f5f5f face="Arial"> </font><a href=mailto:stevemar@ca.ibm.com target=_blank><font size=1 color=#5f5f5f face="Arial"><u>stevemar@ca.ibm.com</u></font></a>
<td width=259 style="border-style:solid;border-color:#000000;border-width:0px 0px 0px 0px;padding:0px 0px;">
<div align=right><font size=1 color=#5f5f5f face="Arial">8200 Warden Ave<br>
Markham, ON L6G 1C7<br>
Canada</font></div></table>
<br>