Hi,
Regarding
"New PR: on the stable.apib to remove parts that are not mature enough (note that these part will not be removed from latest.apib, so discussion on they will continue to eventually produce the next stable iteration of the spec) and to change the "Status" section to a disclaimer in the line to what it was discussed in yesterday audio (i.e. explaining that the specification is stable but slight changes due to further discussion may happen)."
I think it is a good idea to start working in advance in the wording for that "Status" section. We should find a paragraph that captures with enough precision the maturity level of the released document so (as we talked in past week audio) developers have all the information to make informed decisions about using or not using software based in that specification.
This is a first proposal:
"This specification is a release candidate of the NGSIv2 API specification. By "release candidate" we mean that the specification is quite stable, but changes may occur with regard to new release candidates or the final version. In particular changes may be of two types:
* Extensions to the functionality currently specified by this document. Note that in this case there isn't any risk of breaking backward compatibility on existing software implementations.
* Slight modifications in the functionality currently specified by this document, as a consequence of outgoing discussions. Backward compatibility will be taken into account in this case, trying to minimize the impact on existing software implementations. In particular, only completely justified changes impacting backward compatibility will be allowed and "matter of taste" changes will not be allowed.
The following items are under ongoing discussion, so next release candidates of this specification will tackle them: <List to be provided>"
Please, go ahead with any suggestion you may have. Even complete re-wordings if you feel the above paragraph doesn't capture precisely the status of what we are going to release in the upcoming days.
@NEC: regarding <List to be provided>, do you expect any progress on this by tomorrow afternoon, please? In negative case, maybe we should cancel tomorrow audio meeting.
Thanks!
Best regards,
------
Fermín
El 19/05/2016 a las 17:05, Fermín Galán Márquez escribió:
Hi,
Please find the following PR with changes on the NGSIv2 specification in order to fix some minor issues towards the end of May releasing of the "stable" version ("stable" in the sense it was discussed in the audio yesterday).
https://github.com/telefonicaid/fiware-orion/pull/2161
Anybody is welcomed to have a look and comment (you only need a github user account to do comments), specially NEC and Orange. In fact, you will realize that some of the changes are derived from NEC feedback in past emails during last week. In addition, you can use the "LGTM" (Looks Good To Me) acronym in comments to express you are fine with the changes.
Next steps are:
1. Close and merge that PR by next Monday EoB (I understand that 2 bussiness days is ok to review a short PR)
2. New PR: do a proof-read on the whole document. Ken Zangelin has volunteered to do that.
3. New PR: copy the current .apib. So at this point we have lastest.apib and stable.apib (not the actual names, but good enough for the discussion in this bullet list)
4. New PR: on the stable.apib to remove parts that are not mature enough (note that these part will not be removed from latest.apib, so discussion on they will continue to eventually produce the next stable iteration of the spec) and to change the "Status" section to a disclaimer in the line to what it was discussed in yesterday audio (i.e. explaining that the specification is stable but slight changes due to further discussion may happen).
* Needed input for item 4: the "Release Notes" on open discussion topics that we were discussing yesterday. As far as I understood, NEC will provide this input (please tell me if I'm wrong).
I understand that the above plan is aligned with what we discuss on yesterday audio but if that is not the case, please tell me so.
Thanks!
Best regards,
------
Fermín
________________________________
Este mensaje y sus adjuntos se dirigen exclusivamente a su destinatario, puede contener información privilegiada o confidencial y es para uso exclusivo de la persona o entidad de destino. Si no es usted. el destinatario indicado, queda notificado de que la lectura, utilización, divulgación y/o copia sin autorización puede estar prohibida en virtud de la legislación vigente. Si ha recibido este mensaje por error, le rogamos que nos lo comunique inmediatamente por esta misma vía y proceda a su destrucción.
The information contained in this transmission is privileged and confidential information intended only for the use of the individual or entity named above. If the reader of this message is not the intended recipient, you are hereby notified that any dissemination, distribution or copying of this communication is strictly prohibited. If you have received this transmission in error, do not read it. Please immediately reply to the sender that you have received this communication in error and then delete it.
Esta mensagem e seus anexos se dirigem exclusivamente ao seu destinatário, pode conter informação privilegiada ou confidencial e é para uso exclusivo da pessoa ou entidade de destino. Se não é vossa senhoria o destinatário indicado, fica notificado de que a leitura, utilização, divulgação e/ou cópia sem autorização pode estar proibida em virtude da legislação vigente. Se recebeu esta mensagem por erro, rogamos-lhe que nos o comunique imediatamente por esta mesma via e proceda a sua destruição
Since January 1st, old domains won't be supported and messages sent to any domain different to @lists.fiware.org will be lost.
Please, send your messages using the new domain (Fiware-ngsi at lists.fiware.org<mailto:Fiware-ngsi at lists.fiware.org>) instead of the old one.
_______________________________________________
Fiware-ngsi mailing list
Fiware-ngsi at lists.fiware.org<mailto:Fiware-ngsi at lists.fiware.org>
https://lists.fiware.org/listinfo/fiware-ngsi
________________________________
Este mensaje y sus adjuntos se dirigen exclusivamente a su destinatario, puede contener información privilegiada o confidencial y es para uso exclusivo de la persona o entidad de destino. Si no es usted. el destinatario indicado, queda notificado de que la lectura, utilización, divulgación y/o copia sin autorización puede estar prohibida en virtud de la legislación vigente. Si ha recibido este mensaje por error, le rogamos que nos lo comunique inmediatamente por esta misma vía y proceda a su destrucción.
The information contained in this transmission is privileged and confidential information intended only for the use of the individual or entity named above. If the reader of this message is not the intended recipient, you are hereby notified that any dissemination, distribution or copying of this communication is strictly prohibited. If you have received this transmission in error, do not read it. Please immediately reply to the sender that you have received this communication in error and then delete it.
Esta mensagem e seus anexos se dirigem exclusivamente ao seu destinatário, pode conter informação privilegiada ou confidencial e é para uso exclusivo da pessoa ou entidade de destino. Se não é vossa senhoria o destinatário indicado, fica notificado de que a leitura, utilização, divulgação e/ou cópia sem autorização pode estar proibida em virtude da legislação vigente. Se recebeu esta mensagem por erro, rogamos-lhe que nos o comunique imediatamente por esta mesma via e proceda a sua destruição
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.fiware.org/private/fiware-ngsi/attachments/20160524/42f2c467/attachment.html>
You can get more information about our cookies and privacy policies clicking on the following links: Privacy policy Cookies policy