[Fiware-security] API Documentation

[BISSON Pascal]

Dear Wolfgang,

I agree but in the meantime we would have to comply with the format requested by Juanjo as CA. So I do think in any case we would have to do some redrafting. So the only question for me would be to go for a proposal where this redrafting would be kept minimal (and obviously not to the detriment of the content we have to produce - aka Open APIs.

This is why I came with the examples I proposed.

So for me our duty is to collect within the Security team arguments in favor to change Juanjo's proposal to make it less complex.
It is also why I sent an email to Juanjo with initial feedback also counter proposal. But in the meantime I need feedback from you and members of this team (by EOB tomorrow) regarding Juanjo's proposal and what you'd like to keep versus change. This in order to have further arguments at the level of this team to pass to Juanjo for him to consider in the context of final template/guidelines he will issue.

So hearing from you on this. Please also consider proposals of content I formulated or even come with new ones we could discuss.

As for the rest I'm convinced we WP8 can't make it change if other WPs provide no feedback from their side (no feedback meaning they agree with Juanjo's proposal and as such it may happen we would have to follow it ..). As such counting on you to also discuss things with Hans as WP7 lead hoping Hans will step in the discussion at WPL/WPA we have on the topic. Frankly apart from me I see no reaction - no reaction from NSN, Orange, SAP, IBM .... ??? Can't simply figure why !!

Waiting for your feedback on Juanjo's proposal (versus what we can propose from our side).

Best Regards,
Pascal


De : Wolfgang.Steigerwald at telekom.de [mailto:Wolfgang.Steigerwald at telekom.de]
Envoyé : mercredi 4 avril 2012 18:10
À : BISSON Pascal
Cc : fiware-security at lists.fi-ware.eu
Objet : API Documentation

Hallo Pascal,

as I said and showed yesterday we has already our APIs documented in the format you can see in the attachment. I think it would be a unnecessary effort to rewrite the whole documentation.


Best regards

Wolfgang


Deutsche Telekom AG
T-Labs (Research & Innovation)
Dipl.-Inform. Wolfgang Steigerwald
Winterfeldtstr. 21, 10781 Berlin
+4930835354287 (Tel.)
+4930835358408 (Fax)
E-Mail: wolfgang.steigerwald at telekom.de
www.telekom.com

Erleben, was verbindet.

Deutsche Telekom AG
Aufsichtsrat: Prof. Dr. Ulrich Lehner (Vorsitzender)
Vorstand: René Obermann (Vorsitzender),
Dr. Manfred Balz, Reinhard Clemens, Niek Jan van Damme,
Timotheus Höttges, Claudia Nemat, Thomas Sattelberger
Handelsregister: Amtsgericht Bonn HRB 6794
Sitz der Gesellschaft: Bonn
WEEE-Reg.-Nr. DE50478376

Große Veränderungen fangen klein an - Ressourcen schonen und nicht jede E-Mail drucken.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.fiware.org/private/old-fiware-security/attachments/20120404/28993578/attachment.html>