{"id":9594,"date":"2023-09-19T15:18:34","date_gmt":"2023-09-19T13:18:34","guid":{"rendered":"https:\/\/smartdatamodels.org\/?p=9594"},"modified":"2023-09-19T15:18:34","modified_gmt":"2023-09-19T13:18:34","slug":"new-version-of-the-contribution-manual","status":"publish","type":"post","link":"https:\/\/smartdatamodels.org\/index.php\/new-version-of-the-contribution-manual\/","title":{"rendered":"New version of the contribution manual"},"content":{"rendered":"

The contribution manual has minor updates frequently, but now we have created a brand new version<\/p>\n

– Restructuring<\/a> the contents<\/p>\n

– Including explanation on how to use the test service<\/a> for new data models<\/p>\n

– Making more understandable the contribution workflow<\/a><\/p>\n

– Guidelines<\/a> for contributing<\/p>\n

– The list of support channels<\/a>, including the new on discord<\/a><\/p>\n

– Move to the annex<\/a> the slides for the automatic documents generated on the publication process<\/p>\n

and helping to make more understandable to those users recently joining the Smart Data Models initiative.<\/p>\n

As always the shortcut to reach it works: https:\/\/bit.ly\/contribution_manual <\/a><\/p>\n

But you can also find a direct link in these locations<\/p>\n

Upper menu -> Contribution manual<\/a> (7th option)<\/p>\n

Main menu -> documentation -> Contribution manual<\/a> (5th option in the drop down menu)<\/p>\n

Feel free to make your comments on info@smartdatamodels.org<\/a> or as comments in the manual.<\/p>\n

 <\/p>\n","protected":false},"excerpt":{"rendered":"

The contribution manual has minor updates frequently, but now we have created a brand new version – Restructuring the contents – Including explanation on how to use the test service for new data models – Making more understandable the contribution workflow – Guidelines for contributing – The list of support… More…<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[105,107,109,113,115,119,117,88,143,111,125,182,201],"tags":[],"class_list":["post-9594","post","type-post","status-publish","format-standard","hentry","category-cross-sector","category-smart-cities","category-smart-energy-domain","category-smart-environment","category-smart-manufacturing","category-smart-robotics","category-smart-water","category-smart-sensoring","category-smartaeronautics","category-smart-agrifood","category-smartdestinations","category-smarthealth","category-smartlogistics"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"jetpack-related-posts":[{"id":3123,"url":"https:\/\/smartdatamodels.org\/index.php\/update-the-contribution-manual\/","url_meta":{"origin":9594,"position":0},"title":"Update the contribution manual","author":"maestro","date":"21\/09\/2021","format":false,"excerpt":"The contribution maual has been updated. Main changes: Only one normalized example is required (formerly 4) New image Tool for checking properties used on other data models","rel":"","context":"In "Cross Sector"","block_context":{"text":"Cross Sector","link":"https:\/\/smartdatamodels.org\/index.php\/category\/cross-sector\/"},"img":{"alt_text":"","src":"https:\/\/i0.wp.com\/smartdatamodels.org\/wp-content\/uploads\/2021\/09\/cropped-Logo_SmartDataModels.png?resize=350%2C200&ssl=1","width":350,"height":200,"srcset":"https:\/\/i0.wp.com\/smartdatamodels.org\/wp-content\/uploads\/2021\/09\/cropped-Logo_SmartDataModels.png?resize=350%2C200&ssl=1 1x, https:\/\/i0.wp.com\/smartdatamodels.org\/wp-content\/uploads\/2021\/09\/cropped-Logo_SmartDataModels.png?resize=525%2C300&ssl=1 1.5x, https:\/\/i0.wp.com\/smartdatamodels.org\/wp-content\/uploads\/2021\/09\/cropped-Logo_SmartDataModels.png?resize=700%2C400&ssl=1 2x"},"classes":[]},{"id":2038,"url":"https:\/\/smartdatamodels.org\/index.php\/dont-to-these-section-in-the-contribution-manual\/","url_meta":{"origin":9594,"position":1},"title":"Don’t to these section in the contribution manual","author":"maestro","date":"06\/04\/2021","format":false,"excerpt":"In order to reduce the work for the contributors of the new data models, there is a new section on the contribution manual title 'don't do these' with recommendations for the most common poor practices in the contribution process. Although all contributions are welcomed it will save everybody's time by\u2026","rel":"","context":"In "Cross Sector"","block_context":{"text":"Cross Sector","link":"https:\/\/smartdatamodels.org\/index.php\/category\/cross-sector\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":2139,"url":"https:\/\/smartdatamodels.org\/index.php\/update-of-the-contribution-manual-process-image\/","url_meta":{"origin":9594,"position":2},"title":"Update of the contribution manual. Process image","author":"maestro","date":"23\/04\/2021","format":false,"excerpt":"We have drafted the publication process for new data models and for updates. It's the first page of the contribution manual and every box (not in this image) has links to the tools\/resources to be used. Hopefully, it will be more straightforward to be understood. Comments welcomed","rel":"","context":"In "Cross Sector"","block_context":{"text":"Cross Sector","link":"https:\/\/smartdatamodels.org\/index.php\/category\/cross-sector\/"},"img":{"alt_text":"","src":"https:\/\/i0.wp.com\/smartdatamodels.org\/wp-content\/uploads\/2021\/04\/publication_process.png?resize=350%2C200&ssl=1","width":350,"height":200,"srcset":"https:\/\/i0.wp.com\/smartdatamodels.org\/wp-content\/uploads\/2021\/04\/publication_process.png?resize=350%2C200&ssl=1 1x, https:\/\/i0.wp.com\/smartdatamodels.org\/wp-content\/uploads\/2021\/04\/publication_process.png?resize=525%2C300&ssl=1 1.5x, https:\/\/i0.wp.com\/smartdatamodels.org\/wp-content\/uploads\/2021\/04\/publication_process.png?resize=700%2C400&ssl=1 2x, https:\/\/i0.wp.com\/smartdatamodels.org\/wp-content\/uploads\/2021\/04\/publication_process.png?resize=1050%2C600&ssl=1 3x"},"classes":[]},{"id":913,"url":"https:\/\/smartdatamodels.org\/index.php\/updated-the-contribution-manual\/","url_meta":{"origin":9594,"position":3},"title":"updated the contribution manual","author":"maestro","date":"02\/12\/2020","format":false,"excerpt":"The contribution manual (link in the upper menu of main page) is updated due to the change in the approach for documenting the data models. Main changes: Properties' definitions are now included as an attribute in the json schema The specification is generated automatically based on the json schema Json\u2026","rel":"","context":"In "Smart Cities domain"","block_context":{"text":"Smart Cities domain","link":"https:\/\/smartdatamodels.org\/index.php\/category\/smart-cities\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":1896,"url":"https:\/\/smartdatamodels.org\/index.php\/updated-the-contribution-manual-2\/","url_meta":{"origin":9594,"position":4},"title":"Updated the contribution manual","author":"maestro","date":"11\/03\/2021","format":false,"excerpt":"This a general review of the contributions' manual with these changes: Recommendation how to document a property that is an object referencing to a shared schema Change order in the elements (schema recommendation is the most demanded documentation and it is being placed at the beginning) Minor reviews, contact point,\u2026","rel":"","context":"In "Cross Sector"","block_context":{"text":"Cross Sector","link":"https:\/\/smartdatamodels.org\/index.php\/category\/cross-sector\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":9340,"url":"https:\/\/smartdatamodels.org\/index.php\/would-you-use-an-attestation-of-your-contribution-to-sdm\/","url_meta":{"origin":9594,"position":5},"title":"Would you use an attestation of your contribution to SDM?","author":"maestro","date":"28\/07\/2023","format":false,"excerpt":"We are considering to officially provide an attestation of your contributions to SDM. Before launching it officially we have created a drafted document for those contributors with a valid mail and name (there are people who do not want to disclose their contribution). Accordingly, if you browse the database of\u2026","rel":"","context":"In "Cross Sector"","block_context":{"text":"Cross Sector","link":"https:\/\/smartdatamodels.org\/index.php\/category\/cross-sector\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]}],"_links":{"self":[{"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/posts\/9594","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/comments?post=9594"}],"version-history":[{"count":2,"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/posts\/9594\/revisions"}],"predecessor-version":[{"id":9596,"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/posts\/9594\/revisions\/9596"}],"wp:attachment":[{"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/media?parent=9594"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/categories?post=9594"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/tags?post=9594"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}