Hi All, Well, I personally do think there must be something better than ‘javatoscaparser’. I don’t think the language/environment is relevant as part of the name (java) and also, the tool is more than just a parser (that is why is called ‘checker’ through the code).
Documentation wise, in the service sub-project there is a README with a good level of details regarding the REST API and the test directory contains a piece of code that does shows all calls. The checker has Javadoc and I will add a README with common usage scenarios. With respect its scope, well, it covers TOSCA and beyond; it is not bound to a particular profile, supports both 1.0 and 1.1 and any mix, it is built to be extensible: one can add new constructs/extensions (as long as the new grammar can be identified through the document definitions entry) and can plug in new checks at both syntax and cross checking stages. Serban From: Arthur Berezin [mailto:[email protected]] Sent: Tuesday, November 07, 2017 12:16 PM To: denghui (L) <[email protected]> Cc: [email protected]; JORA, SERBAN (SERBAN) <[email protected]>; Rittwik Jana <[email protected]>; [email protected]; [email protected]; [email protected]; BENNETT, RICH <[email protected]>; [email protected]; onap-discuss <[email protected]> Subject: Re: Modeling Project doc missing On Tue, Nov 7, 2017 at 1:39 PM denghui (L) <[email protected]<mailto:[email protected]>> wrote: Hi Eric, Trimed and inline please, == > Hi Serban, there is one question from Eric for you below Hi Arthur, there is one question from Eric for you inside I think we should provide more example how to use it bot using CLI and API. We should also provide some documentation to explain the TOSCA models that can be managed by the tool (like for the NFV parser: http://onap.readthedocs.io/en/latest/submodules/modeling/toscaparsers.git/docs/nfvparser/userguide/feature.userguide.html<https://urldefense.proofpoint.com/v2/url?u=http-3A__onap.readthedocs.io_en_latest_submodules_modeling_toscaparsers.git_docs_nfvparser_userguide_feature.userguide.html&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=IwRhUoMb3g5nrM7PDK5OWagN3Sd4PSlpXLGzfsFqV1w&m=SkXQsjoFgJBoTIgsWPjnLHXQb7HSYqbaSiZq8I4yS_E&s=IIwMi-cY0Ct11Q2KJhO1IM-yE4OgFAQ6K6LUw7uS7FM&e=>) I can check if there is some example in the code. == >As you may know, release 1 is not very stable release, there will be many changes in release 2, especially for modeling part, TSC chair only ask for minimal documentation requirement for each project, I can’t ask more requirement to developers at this moment, some of them are not just busy with this project. For API, It is based on wiki documentation, but it is confusing. We have 3 Parsers describes while only 2 are defined in the Documentation with different names Wiki: • Openstack Tosca Parser API: (Python) • Apache ARIA-TOSCA(Python + CLI + REST API) • Java based Tosca Parser API: (Java) DOC : javatoscachecker<https://urldefense.proofpoint.com/v2/url?u=http-3A__onap.readthedocs.io_en_latest_submodules_modeling_toscaparsers.git_docs_javatoscachecker_index.html&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=IwRhUoMb3g5nrM7PDK5OWagN3Sd4PSlpXLGzfsFqV1w&m=SkXQsjoFgJBoTIgsWPjnLHXQb7HSYqbaSiZq8I4yS_E&s=JW9WyXcZKkdU0rYJ3rXk4-ZJA33VntQIdpITcUBXXGg&e=> NFV Parser<https://urldefense.proofpoint.com/v2/url?u=http-3A__onap.readthedocs.io_en_latest_submodules_modeling_toscaparsers.git_docs_nfvparser_index.html&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=IwRhUoMb3g5nrM7PDK5OWagN3Sd4PSlpXLGzfsFqV1w&m=SkXQsjoFgJBoTIgsWPjnLHXQb7HSYqbaSiZq8I4yS_E&s=XwEDSIH08jXS82NDHrRx4Ukv8shDVnUm2sOyljF4ta8&e=> I assume that Java based Tosca Parser API = javatoscachecker<https://urldefense.proofpoint.com/v2/url?u=http-3A__onap.readthedocs.io_en_latest_submodules_modeling_toscaparsers.git_docs_javatoscachecker_index.html&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=IwRhUoMb3g5nrM7PDK5OWagN3Sd4PSlpXLGzfsFqV1w&m=SkXQsjoFgJBoTIgsWPjnLHXQb7HSYqbaSiZq8I4yS_E&s=JW9WyXcZKkdU0rYJ3rXk4-ZJA33VntQIdpITcUBXXGg&e=> And NFV Parser<https://urldefense.proofpoint.com/v2/url?u=http-3A__onap.readthedocs.io_en_latest_submodules_modeling_toscaparsers.git_docs_nfvparser_index.html&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=IwRhUoMb3g5nrM7PDK5OWagN3Sd4PSlpXLGzfsFqV1w&m=SkXQsjoFgJBoTIgsWPjnLHXQb7HSYqbaSiZq8I4yS_E&s=XwEDSIH08jXS82NDHrRx4Ukv8shDVnUm2sOyljF4ta8&e=> = Openstack Tosca Parser API: (Python) Which name do we keep: Java based Tosca Parser and NFV Parser ? == > Serban, do you have any suggestion? Where is documented Apache ARIA-TOSCA(Python + CLI + REST API) ? == > I heard that Aria would like their code in SO project, so I don’t know where is their document, Arthur, do you have answer here? The complete project reference documentation can be found on the proejct's home page here: http://ariatosca.incubator.apache.org/docs/html/index.html<https://urldefense.proofpoint.com/v2/url?u=http-3A__ariatosca.incubator.apache.org_docs_html_index.html&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=IwRhUoMb3g5nrM7PDK5OWagN3Sd4PSlpXLGzfsFqV1w&m=SkXQsjoFgJBoTIgsWPjnLHXQb7HSYqbaSiZq8I4yS_E&s=UwcFkV2xbyPqaO4UbobzJuBbVh4qSMLiCxKv00wFnw8&e=> I suggest starting with the getting started guild here: http://ariatosca.incubator.apache.org/getting-started/<https://urldefense.proofpoint.com/v2/url?u=http-3A__ariatosca.incubator.apache.org_getting-2Dstarted_&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=IwRhUoMb3g5nrM7PDK5OWagN3Sd4PSlpXLGzfsFqV1w&m=SkXQsjoFgJBoTIgsWPjnLHXQb7HSYqbaSiZq8I4yS_E&s=6gKDGb8cXOFqfzQs9wf8nnB2z8kvKV91SbjQGvbiaTI&e=> Additionally, you can find more some concrete examples of TOSCA Modeling (Incluidng basic HelloWorld, and more complex ClearWater example) here: https://github.com/apache/incubator-ariatosca/tree/master/examples<https://urldefense.proofpoint.com/v2/url?u=https-3A__github.com_apache_incubator-2Dariatosca_tree_master_examples&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=IwRhUoMb3g5nrM7PDK5OWagN3Sd4PSlpXLGzfsFqV1w&m=SkXQsjoFgJBoTIgsWPjnLHXQb7HSYqbaSiZq8I4yS_E&s=9Ky4kTWCnt7HEZzVb7JSQbZRGB1xgMa3a7rqtfL6cuI&e=> Best, Arthur We introduced a API ref page within the documentation. I would like to update it with a link to the API rst page from modeling. I propose the following changes. • Merge wiki documentation with RST files if my assumptions are ok • Add an API page for the modeling that will give the links towards the various Parsers API • I update the global API ref for the documentation with the new API page for modeling == > we are asked to publish API in the architecture team, not in modeling, but I am fine with this contribution, we could create another folder on it. Thanks DENG Hui I can do it today if your are ok. Best Regards Eric De : denghui (L) [mailto:[email protected]] Envoyé : mardi 7 novembre 2017 04:11 À : DEBEAU Eric IMT/OLN Cc : BENNETT, RICH Objet : RE: Modeling Project doc missing Hello Eric Thanks a lot for your kind offer. Here is the updated link : http://onap.readthedocs.io/en/latest/submodules/modeling/toscaparsers.git/docs/javatoscachecker/index.html<https://urldefense.proofpoint.com/v2/url?u=http-3A__onap.readthedocs.io_en_latest_submodules_modeling_toscaparsers.git_docs_javatoscachecker_index.html&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=IwRhUoMb3g5nrM7PDK5OWagN3Sd4PSlpXLGzfsFqV1w&m=SkXQsjoFgJBoTIgsWPjnLHXQb7HSYqbaSiZq8I4yS_E&s=JW9WyXcZKkdU0rYJ3rXk4-ZJA33VntQIdpITcUBXXGg&e=> Feel free to let us know if we need to make any further any update. For API, it has been documented on the wiki page https://wiki.onap.org/display/DW/Modeling+API<https://urldefense.proofpoint.com/v2/url?u=https-3A__wiki.onap.org_display_DW_Modeling-2BAPI&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=IwRhUoMb3g5nrM7PDK5OWagN3Sd4PSlpXLGzfsFqV1w&m=SkXQsjoFgJBoTIgsWPjnLHXQb7HSYqbaSiZq8I4yS_E&s=HKDOX0VgN0I6PIevtOWcfvMpyM1K5hDYvuSPlVS0T2A&e=> thanks a lot DENG Hui From: [email protected]<mailto:[email protected]> [mailto:[email protected]] Sent: Tuesday, November 7, 2017 1:21 AM To: denghui (L) <[email protected]<mailto:[email protected]>> Cc: BENNETT, RICH <[email protected]<mailto:[email protected]>> Subject: RE: Modeling Project doc missing Hello Hui The documentation for javatoscachecker is still missing We also need to identify if the parsers offer some API. It still unclear for me if the parsers are only some libraries or independent components offering API. If you have some issues to translate the initial PDF file provided for javatoscachecker, we may find a solution. Best Regards Eric De : denghui (L) [mailto:[email protected]] Envoyé : dimanche 29 octobre 2017 07:51 À : Gildas Lanilis; JORA, SERBAN (SERBAN); [email protected]<mailto:[email protected]> Cc : Rittwik Jana; Lingli Deng; [email protected]<mailto:[email protected]>; CHAWKI Jamil IMT/OLN; DEBEAU Eric IMT/OLN; GLOVER, GREG L; Christopher Donley (Chris); BENNETT, RICH Objet : RE: Modeling Project doc missing Hi Serban and Xiaodong. I have created doc folder under the toscaparsers, you could submit/commit your RST document into your folder separately: 1) toscaparsers/docs/javatoscachecker 2) toscaparsers/docs/nfvparser thanks a lot for your kind help, deadline for your submission will be Monday Gildas, I am not sure the deadline will be Monday Pacific time or PTL meeting time? Best regards, DENG Hui From: Gildas Lanilis Sent: Saturday, October 28, 2017 7:24 AM To: JORA, SERBAN (SERBAN) <[email protected]<mailto:[email protected]>>; [email protected]<mailto:[email protected]> Cc: Rittwik Jana <[email protected]<mailto:[email protected]>>; Lingli Deng <[email protected]<mailto:[email protected]>>; [email protected]<mailto:[email protected]>; 'CHAWKI Jamil IMT/OLN' <[email protected]<mailto:[email protected]>>; [email protected]<mailto:[email protected]>; GLOVER, GREG L <[email protected]<mailto:[email protected]>>; denghui (L) <[email protected]<mailto:[email protected]>>; Christopher Donley (Chris) <[email protected]<mailto:[email protected]>>; BENNETT, RICH <[email protected]<mailto:[email protected]>> Subject: RE: Modeling Project doc missing Hi Serban, Xiaodong, To help you out, here is a bit of background on where we stand and what is left in term of Documentation in ReadTheDocs<https://urldefense.proofpoint.com/v2/url?u=http-3A__onap.readthedocs.io_&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=IwRhUoMb3g5nrM7PDK5OWagN3Sd4PSlpXLGzfsFqV1w&m=SkXQsjoFgJBoTIgsWPjnLHXQb7HSYqbaSiZq8I4yS_E&s=907E_PDYBnNOKl_iML6LAjBaJg9wATwic5tjqTh5y-M&e=> Each team representing a project has to have a section in ReadTheDocs to document their project. The expectation for each project usually covers the following (further documented here<https://urldefense.proofpoint.com/v2/url?u=http-3A__onap.readthedocs.io_en_latest_guides_onap-2Ddeveloper_how-2Dto-2Duse-2Ddocs_include-2Ddocumentation.html-23templates-2Dand-2Dexamples&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=IwRhUoMb3g5nrM7PDK5OWagN3Sd4PSlpXLGzfsFqV1w&m=SkXQsjoFgJBoTIgsWPjnLHXQb7HSYqbaSiZq8I4yS_E&s=nade2mEkUFpw9lGpxm64TpX_HRPf_OuzuNugxMyYV7Q&e=>) topics: • Architecture • Offered APIs • Consumed APIs • Delivery • Logging • Installation • Configuration • Administration • Human Interfaces • Release Notes If we step back, we know Modeling has two hats: 1) Modeling Sub committee 2) Modeling project The documentation related to the Modeling sub-committee is already in ReadTheDocs at http://onap.readthedocs.io/en/latest/submodules/modeling/modelspec.git/docs/index.html<https://urldefense.proofpoint.com/v2/url?u=http-3A__onap.readthedocs.io_en_latest_submodules_modeling_modelspec.git_docs_index.html&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=IwRhUoMb3g5nrM7PDK5OWagN3Sd4PSlpXLGzfsFqV1w&m=SkXQsjoFgJBoTIgsWPjnLHXQb7HSYqbaSiZq8I4yS_E&s=2WHNkIAq57sotzDKBlz0yqsWLSDalJrUWALD54jfTTA&e=> What is missing is the documentation related to the Modeling project (NFV parser and Javatoscachecker) on the above bullets point. The git structure for Modeling sub-committee repo is already in place at /modeling/modelspec/docs. Consult with Greg and Rich if you need further info or have doubts on how to move forward with ReadTheDocs. Further guidelines are also available in the wiki in https://wiki.onap.org/download/attachments/15995371/Documentation%20Guidelines%209-11-2017.pptm?api=v2<https://urldefense.proofpoint.com/v2/url?u=https-3A__wiki.onap.org_download_attachments_15995371_Documentation-2520Guidelines-25209-2D11-2D2017.pptm-3Fapi-3Dv2&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=IwRhUoMb3g5nrM7PDK5OWagN3Sd4PSlpXLGzfsFqV1w&m=SkXQsjoFgJBoTIgsWPjnLHXQb7HSYqbaSiZq8I4yS_E&s=HkkPldQ2zUpG93EjsvnmH763uRK_DZpphT0Yej8azxc&e=> All, I have tried to be as much as informative as possible to help Modeling move forward. Feel free to add-suggest any information that would help in getting a doc that everyone would love to read. Let me know if you have any questions, I will be glad to help. Thanks, Gildas ONAP Release Manager 1 415 238 6287<tel:(415)%20238-6287> From: denghui (L) Sent: Thursday, October 26, 2017 8:29 AM To: JORA, SERBAN (SERBAN) <[email protected]<mailto:[email protected]>>; 'CHAWKI Jamil IMT/OLN' <[email protected]<mailto:[email protected]>>; [email protected]<mailto:[email protected]>; GLOVER, GREG L <[email protected]<mailto:[email protected]>> Cc: Gildas Lanilis <[email protected]<mailto:[email protected]>>; Rittwik Jana <[email protected]<mailto:[email protected]>>; [email protected]<mailto:[email protected]>; Lingli Deng <[email protected]<mailto:[email protected]>>; [email protected]<mailto:[email protected]> Subject: RE: Modeling Project doc missing Hi Serban The doc about your code, http://onap.readthedocs.io/en/latest/guides/onap-developer/how-to-use-docs/include-documentation.html<https://urldefense.proofpoint.com/v2/url?u=http-3A__onap.readthedocs.io_en_latest_guides_onap-2Ddeveloper_how-2Dto-2Duse-2Ddocs_include-2Ddocumentation.html&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=IwRhUoMb3g5nrM7PDK5OWagN3Sd4PSlpXLGzfsFqV1w&m=SkXQsjoFgJBoTIgsWPjnLHXQb7HSYqbaSiZq8I4yS_E&s=vT72iJ8N8wmgNUDvw4aq2Fn07EcHVucazeS4H_p2w24&e=> your could refer to :VFC project or SO project http://onap.readthedocs.io/en/latest/guides/onap-developer/developing/index.html<https://urldefense.proofpoint.com/v2/url?u=http-3A__onap.readthedocs.io_en_latest_guides_onap-2Ddeveloper_developing_index.html&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=IwRhUoMb3g5nrM7PDK5OWagN3Sd4PSlpXLGzfsFqV1w&m=SkXQsjoFgJBoTIgsWPjnLHXQb7HSYqbaSiZq8I4yS_E&s=ghTMtlqeo-PpYXJUocVkkSZPTehJtEtaX_r0IZpGsZ0&e=> http://onap.readthedocs.io/en/latest/submodules/vfc/nfvo/lcm.git/docs/index.html<https://urldefense.proofpoint.com/v2/url?u=http-3A__onap.readthedocs.io_en_latest_submodules_vfc_nfvo_lcm.git_docs_index.html&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=IwRhUoMb3g5nrM7PDK5OWagN3Sd4PSlpXLGzfsFqV1w&m=SkXQsjoFgJBoTIgsWPjnLHXQb7HSYqbaSiZq8I4yS_E&s=ynIm9OgAke3hIW-UGFr9Vjch2EbKJP2qhTPw2GOawYs&e=> http://onap.readthedocs.io/en/latest/submodules/so.git/docs/index.html<https://urldefense.proofpoint.com/v2/url?u=http-3A__onap.readthedocs.io_en_latest_submodules_so.git_docs_index.html&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=IwRhUoMb3g5nrM7PDK5OWagN3Sd4PSlpXLGzfsFqV1w&m=SkXQsjoFgJBoTIgsWPjnLHXQb7HSYqbaSiZq8I4yS_E&s=HUFfNPOPJ3vd6ZkQcg4Gs0G_Hk1rN9-LHP52ghWzruc&e=> we need submit those RST files into modeling project repo. thanks a lot for your help Best regards, DENG Hui From: JORA, SERBAN (SERBAN) [mailto:[email protected]] Sent: Thursday, October 26, 2017 11:13 PM To: denghui (L) <[email protected]<mailto:[email protected]>>; 'CHAWKI Jamil IMT/OLN' <[email protected]<mailto:[email protected]>>; [email protected]<mailto:[email protected]>; GLOVER, GREG L <[email protected]<mailto:[email protected]>> Cc: Gildas Lanilis <[email protected]<mailto:[email protected]>>; Rittwik Jana <[email protected]<mailto:[email protected]>>; [email protected]<mailto:[email protected]>; Lingli Deng <[email protected]<mailto:[email protected]>>; [email protected]<mailto:[email protected]> Subject: RE: Modeling Project doc missing Hi Deng, Everybody, I think I missed a step here, what documents are we talking about? Thank you, Serban From: denghui (L) [mailto:[email protected]] Sent: Thursday, October 26, 2017 11:02 AM To: 'CHAWKI Jamil IMT/OLN' <[email protected]<mailto:[email protected]>>; [email protected]<mailto:[email protected]>; GLOVER, GREG L <[email protected]<mailto:[email protected]>> Cc: Gildas Lanilis <[email protected]<mailto:[email protected]>>; Rittwik Jana <[email protected]<mailto:[email protected]>>; JORA, SERBAN (SERBAN) <[email protected]<mailto:[email protected]>>; [email protected]<mailto:[email protected]>; Lingli Deng <[email protected]<mailto:[email protected]>>; [email protected]<mailto:[email protected]> Subject: Modeling Project doc missing Hello Jamil, Eric and Greg I heard today about what is missing about the document about the binary code, could you kindly help to remind if others are missing for modeling project? Hi Serban and Xiaodong Could you help to submit those doc before end of Sunday, PTL meeting will go through this at the deadline of Monday. Thanks a lot DENG Hui _________________________________________________________________________________________________________________________ Ce message et ses pieces jointes peuvent contenir des informations confidentielles ou privilegiees et ne doivent donc pas etre diffuses, exploites ou copies sans autorisation. Si vous avez recu ce message par erreur, veuillez le signaler a l'expediteur et le detruire ainsi que les pieces jointes. Les messages electroniques etant susceptibles d'alteration, Orange decline toute responsabilite si ce message a ete altere, deforme ou falsifie. Merci. This message and its attachments may contain confidential or privileged information that may be protected by law; they should not be distributed, used or copied without authorisation. If you have received this email in error, please notify the sender and delete this message and its attachments. As emails may be altered, Orange is not liable for messages that have been modified, changed or falsified. Thank you. _________________________________________________________________________________________________________________________ Ce message et ses pieces jointes peuvent contenir des informations confidentielles ou privilegiees et ne doivent donc pas etre diffuses, exploites ou copies sans autorisation. Si vous avez recu ce message par erreur, veuillez le signaler a l'expediteur et le detruire ainsi que les pieces jointes. Les messages electroniques etant susceptibles d'alteration, Orange decline toute responsabilite si ce message a ete altere, deforme ou falsifie. Merci. This message and its attachments may contain confidential or privileged information that may be protected by law; they should not be distributed, used or copied without authorisation. If you have received this email in error, please notify the sender and delete this message and its attachments. As emails may be altered, Orange is not liable for messages that have been modified, changed or falsified. Thank you.
_______________________________________________ onap-discuss mailing list [email protected] https://lists.onap.org/mailman/listinfo/onap-discuss
