{"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,"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},"jetpack_post_was_ever_published":false},"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_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":2035,"url":"https:\/\/smartdatamodels.org\/index.php\/contribution-checklist\/","url_meta":{"origin":9594,"position":5},"title":"Contribution checklist","author":"maestro","date":"05\/04\/2021","format":false,"excerpt":"There is a new option in the main menu Data Models -> Contribution Checklist It is strongly recommended to pass every element before submitting your new data model. See below the checklist","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":[]}],"jetpack_featured_media_url":"","_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}]}}