The release controlled ONAP documentation, including APIs, should all end up somewhere under here: http://onap.readthedocs.io/en/latest/index.html#
But there's nothing there for SDN-C APIs at the moment. There's lots of other things missing too, but the API's are kind of important ... 8^} best regards Steven Wright, MBA, PhD, JD. [Tech Integration] AT&T Services Inc. 1057 Lenox Park Blvd NE, STE 4D28 Atlanta, GA 30319 P: 470.415.3156 [email protected]<mailto:[email protected]> www.linkedin.com/in/drstevenawright/<http://www.linkedin.com/in/drstevenawright/> From: FREEMAN, BRIAN D Sent: Wednesday, August 30, 2017 4:54 PM To: WRIGHT, STEVEN A <[email protected]>; TIMONEY, DAN <[email protected]> Cc: GLOVER, GREG L <[email protected]>; [email protected] Subject: RE: [SDNC] documentation on APIs The NBI for SDNC is swagger based and I thought Dan had provided those swagger url's/files. Brian From: WRIGHT, STEVEN A Sent: Wednesday, August 30, 2017 4:53 PM To: FREEMAN, BRIAN D <[email protected]<mailto:[email protected]>>; TIMONEY, DAN <[email protected]<mailto:[email protected]>> Cc: GLOVER, GREG L <[email protected]<mailto:[email protected]>>; [email protected]<mailto:[email protected]> Subject: RE: [SDNC] documentation on APIs The question is when will the API documentation from the SDNC group be published at onap.readthedocs.io ? best regards Steven Wright, MBA, PhD, JD. [Tech Integration] AT&T Services Inc. 1057 Lenox Park Blvd NE, STE 4D28 Atlanta, GA 30319 P: 470.415.3156 [email protected]<mailto:[email protected]> www.linkedin.com/in/drstevenawright/<http://www.linkedin.com/in/drstevenawright/> From: FREEMAN, BRIAN D Sent: Wednesday, August 30, 2017 4:48 PM To: WRIGHT, STEVEN A <[email protected]<mailto:[email protected]>>; TIMONEY, DAN <[email protected]<mailto:[email protected]>> Cc: GLOVER, GREG L <[email protected]<mailto:[email protected]>>; [email protected]<mailto:[email protected]> Subject: RE: [SDNC] documentation on APIs Steven, I dont understand the question. VNFs dont call SDNC , SDNC uses southbound protocols to configure VNFs like netconf, restconf , bgp, pcep, rest and as a last resort (and a large precentage) cli. Brian From: [email protected]<mailto:[email protected]> [mailto:[email protected]] On Behalf Of WRIGHT, STEVEN A Sent: Wednesday, August 30, 2017 4:34 PM To: TIMONEY, DAN <[email protected]<mailto:[email protected]>> Cc: GLOVER, GREG L <[email protected]<mailto:[email protected]>>; [email protected]<mailto:[email protected]> Subject: [onap-discuss] [SDNC] documentation on APIs ***Security Advisory: This Message Originated Outside of AT&T *** Reference http://cso.att.com/EmailSecurity/IDSP.html for more information. With the API freeze at the M3 milestone, I am interested in the availability of the Amsterdam release SDN-C API documentation from the SDN-C project. I could find no SDN-C API documentation on the Project wiki<https://urldefense.proofpoint.com/v2/url?u=https-3A__wiki.onap.org_display_DW_Software-2BDefined-2BNetwork-2BController-2BProject&d=DwMFAg&c=LFYZ-o9_HUMeMTSQicvjIg&r=e3d1ehx3DI5AoMgDmi2Fzw&m=MAcfvgz4v8eevjz8WPfe_YpJIzVVF-uNqn6RE8e3CC4&s=74zf3kpCfkwgoHpIvYlXq6ynbNTAJqGK7DUlTv-i_Oo&e=> . The Documentation project provides the documentation tool chain for all ONAP projects ( refer Documentation section M1 Release planning documentation). The Documentation Project tool chain delivers release-controlled ONAP documentation to http://onap.readthedocs.io/en/latest/index.html<https://urldefense.proofpoint.com/v2/url?u=http-3A__onap.readthedocs.io_en_latest_index.html&d=DwMFAg&c=LFYZ-o9_HUMeMTSQicvjIg&r=e3d1ehx3DI5AoMgDmi2Fzw&m=MAcfvgz4v8eevjz8WPfe_YpJIzVVF-uNqn6RE8e3CC4&s=WqFUeIV9J33yUYM9jeCftWK382JHEjyLzaRvE8v6t_U&e=> There is currently no documentation on SDN-C APIs available at http://onap.readthedocs.io/en/latest/index.html<https://urldefense.proofpoint.com/v2/url?u=http-3A__onap.readthedocs.io_en_latest_index.html&d=DwMFAg&c=LFYZ-o9_HUMeMTSQicvjIg&r=e3d1ehx3DI5AoMgDmi2Fzw&m=MAcfvgz4v8eevjz8WPfe_YpJIzVVF-uNqn6RE8e3CC4&s=WqFUeIV9J33yUYM9jeCftWK382JHEjyLzaRvE8v6t_U&e=> (The documentation tool chain/Jenkins jobs are up and working now for other projects) Can the SDN-C project/PTL identify a contact person to work on the documentation aspects of SDN-C? Ideally the contact should be identified here<https://urldefense.proofpoint.com/v2/url?u=https-3A__wiki.onap.org_display_DW_Doc-2BProject-2BCoverage-2BMatrix&d=DwMFAg&c=LFYZ-o9_HUMeMTSQicvjIg&r=e3d1ehx3DI5AoMgDmi2Fzw&m=MAcfvgz4v8eevjz8WPfe_YpJIzVVF-uNqn6RE8e3CC4&s=jE5FjYon5h0GFxI965j3TtjOY0z4dTA-f4OKL15mM3k&e=>. The general process on documenting projects in ONAP is described here<https://urldefense.proofpoint.com/v2/url?u=http-3A__onap.readthedocs.io_en_latest_guide_onap-2Ddeveloper_how-2Dto-2Duse-2Ddocs_index.html&d=DwMFAg&c=LFYZ-o9_HUMeMTSQicvjIg&r=e3d1ehx3DI5AoMgDmi2Fzw&m=MAcfvgz4v8eevjz8WPfe_YpJIzVVF-uNqn6RE8e3CC4&s=A9wJC69-V_nCtWamGiivrj-TtDBgClM5qDOyQ-UTllM&e=>. VNFs have requirements to support SDN-C APIs. From VNFRQTS project, we are trying to complete VNFRQTS-87<https://urldefense.proofpoint.com/v2/url?u=https-3A__jira.onap.org_browse_VNFRQTS-2D87&d=DwMFAg&c=LFYZ-o9_HUMeMTSQicvjIg&r=e3d1ehx3DI5AoMgDmi2Fzw&m=MAcfvgz4v8eevjz8WPfe_YpJIzVVF-uNqn6RE8e3CC4&s=JvCpt3cNWnU7uzoOXtXSGwGnSb2CMycgy0JO1F5qAO8&e=> in our current sprint-3. To complete this, we need at least a chapter heading available at http://onap.readthedocs.io/en/latest/index.html<https://urldefense.proofpoint.com/v2/url?u=http-3A__onap.readthedocs.io_en_latest_index.html&d=DwMFAg&c=LFYZ-o9_HUMeMTSQicvjIg&r=e3d1ehx3DI5AoMgDmi2Fzw&m=MAcfvgz4v8eevjz8WPfe_YpJIzVVF-uNqn6RE8e3CC4&s=WqFUeIV9J33yUYM9jeCftWK382JHEjyLzaRvE8v6t_U&e=> for our requirements deliverable to point to for SDN-C API documentation. Our VNFRQTS Sprint 3 is due to complete September 12, so we would appreciate if you could have the SDN-C API documentation outline up at http://onap.readthedocs.io/en/latest/index.html<https://urldefense.proofpoint.com/v2/url?u=http-3A__onap.readthedocs.io_en_latest_index.html&d=DwMFAg&c=LFYZ-o9_HUMeMTSQicvjIg&r=e3d1ehx3DI5AoMgDmi2Fzw&m=MAcfvgz4v8eevjz8WPfe_YpJIzVVF-uNqn6RE8e3CC4&s=WqFUeIV9J33yUYM9jeCftWK382JHEjyLzaRvE8v6t_U&e=> within the next week. Please advise if you need help to achieve this. best regards Steven Wright, MBA, PhD, JD. [Tech Integration] AT&T Services Inc. 1057 Lenox Park Blvd NE, STE 4D28 Atlanta, GA 30319 P: 470.415.3156 [email protected]<mailto:[email protected]> www.linkedin.com/in/drstevenawright/<https://urldefense.proofpoint.com/v2/url?u=http-3A__www.linkedin.com_in_drstevenawright_&d=DwMFAg&c=LFYZ-o9_HUMeMTSQicvjIg&r=e3d1ehx3DI5AoMgDmi2Fzw&m=MAcfvgz4v8eevjz8WPfe_YpJIzVVF-uNqn6RE8e3CC4&s=_0h3pebnRSNODYnNqSQE3rr8iYgc7CcihkddB2WFmXQ&e=>
_______________________________________________ onap-discuss mailing list [email protected] https://lists.onap.org/mailman/listinfo/onap-discuss
