Add graphs.

Author: ioggstream

connexion-101/021-api-canvas.md

@@ -33,5 +33,6 @@ The canvas maps *who*, *what*, *how*, and *why* in order to:
 | Private organisations                                   | Publish information about defibrillators in a given area | Map management tools                                   | Area ID determined by the requester                | List of defibrillators with GPS coordinates and status (available / unavailable) | Publish the registry on maps or display screens (hotels, buses, metro, …) |
 | Open data / civic hackers / journalists / public bodies | Monitor DAE distribution across a territory              | Data-science tools: bulk download or dedicated clients | Area ID and timestamp, determined by the requester | List of defibrillators with GPS coordinates and status (available / unavailable) | Inform the public about defibrillator coverage; evaluate service coverage |
 
+Here's the API OAS Checker canvas tool :)
 
-See this [example](https://italia.github.io/api-oas-checker/#text=PYBwpgdghiCWBcACAzAOgAyoEwChYQDNh4dFEA3MAJwGdZgIkAiTTARidMQBdZuAbMEgAiYArABGVWP35RuwaVwAeAWhoBXALZaoVAJ5IAkhAAmscrFMaoiWIlNjJ02fMX3N-HtWkLpwLkcaAGNpEF4GJAAfLjIAYjjEUXEpGTk-WBxYxABFDTAablsAQQAFI0RwKi0wbm4wRFtuDTr7c0QwQQhgvTBshv5gHv5YAC9R3rsHJ1TXDMqqAsheOwhEDQgAcl6oVGyTYH5uRcrqGrqGqC8qmgYry5b3cbcHewBzAt5F7MFVomqoKN6BB7PgOl1gsA9tkAKKbda8X5VYIACwAl6hMVx6tUaAB5AgAZWolmCQkQmxRdRANHgAHo6QoaKgwMooFoQIJUHxNlxIRAisFuCQyGQwLoZEgqMAJNQFAABers8xvPj3VBvYCUKgQKF8bLQGoiWAgPS8GoC4CIAAqVCgNH+uiBDAawlgqqKgmyGio-CQlOptIZ+F15EBwLAGq13O4vKKb1pOFUZEN5JAGgkIxoKNiQVCJoijEQAD5VNlShnM7AeohfvhHeGGB4NG0Zi50u4kyn2eTdNAPrmCvnwsCkKXy2daisoG8Rh0BW13p9YCdWyl224lMnEKmkFom35ByEwoWx2XRYgALIHxQz1VWxyyK2FF6P-ibMpGPY0EnURPJn0-UQKluBpek6RgWAWTZDlBDpRx1zSTdYDpch0ECIcT1HBZgGsIVgS7QCkHgtskIyVD0LIPMsMiaZKEGEALW4FR1CgMwJGAZQkGOfIcEhDkXQFRMyBCFFxXtEVRVKaVM3FSSLwAEkWAhmBAsCGSVLQVTVLkPRRDNuWAOlQEgSC6V0QpqBI8QQULZl9HZfg4jpfiQEE7gaDpUTxM86SZUELROAvZJnDIxQwCMUx5NFbh9HAJBCmkCA3myMgG2FdYW1MVLEF0ZQABlIDebgUSQZAADYcq0fBCuSkqysqi8yFNC4dX9ABtKBVFGdBVAATlUABdABvCqAF9eSa6ZjwLbDxymsh8s2KxllgcQel4cgrQ2CwhgfTppkQuZwr2KbWXZTlyQAdgAFjYNhgmQZArtULACD6rqboIcqJH6+7TFUUw2AkAAONgbrAKAbuCABWK7shC2YO0WaKyFi+LEBlAArMAhRyqBTHMQsrj8qpeAKJACCuH8csWABHFtFiixB2qsAAaRAX2aGgOY+QpwsGnKQGlMnYApnKyCsVGmqUsRmGc1z3M87yLLpRGNz8CLTCChauY0YSFrRuLyUS-AUsNsUIG0JBOtaLaOd1CBVHkTbgEFi2Ohgy6kBd3aJcQPnNeli90ZN44zf9sg8tq4rSpQXAPZanEi02TruuKVQAC1er6gAdVQAH1BoAakmi3qNm2ionPD3EEhcwyUQIxSmKaZZE2ZYGlRBpA9gEIGhkQ7QuOxZTtrgBxOcWlWxpp4XDbWy23UOhoH8TmkAhqEkGR7Cud9O7Hw3ztg8kmAAYQLmEbqurAdbIcewGAAApQk8QAOQAMUh5oUZy0OkGxrjZiU0CZE2BCTEWcoxa0kQFTfgNMpr00ZmAKK-tkyhzQQHR+5wDBC0gVQcmMDEAADIH7P1fp-b+PowCkygQUf2-9I48GNglcOyUmGQGtizL+8hqHuwWh8YAODDBMP-pjCQOM8YeyQSuFBNtQ4c0hIocw0B6g0H4YbUBfBwH8FoQQ6BlNqZ9ETvgwhwcmqMNrjFFhnM2HmysfOLh7VSjAHwNwDRFslFUBUfIcWDjmEYz0HafQTCLx5SMPULQMCE4OOqhACJ4pomhNFHwRJ5jDZiKtloWUVBkkXnSkgUwwAMxen8VHfAsAtBcNUGwEGlEyl5UqVw2p9SyDqzCosMh0sK4jirjXKaeRPjPm7rodYNBbByE5m4+0dBEAAE1iiXnyqcKgdchFuSoN8Q2dABS+x6ExAYDRhagGkLUAAB68dYaxgBvA+HUZ8kAJj+31pMGowQegghoNVS51AUFqlOdwM5h9rEY0AVIpqWjia6NMQY2BRjaZgAZrI1BU10HGxysmQRwiMU4VFvQqaxy8UGymgAHhJUgAAVGQl+78eE-xoTC-FC1CV0OJQtWWKkKQK3WUrLyIz7Rq1IiPMAZcLzH29gwmxdLqH+yxbUAw6SAnkhcW4phXifFqJtogG67AsDIA5uDVAbA9UeIvCy-RfiLZS0QLde6j1nqvXep9b6v0+r-UBsDMGEMoaw3hh7PWMDfZbSYYHcKSAL5XxvgjIVyNYBdL-jYsFwCmo9NPIgAAqtc25U4rTUsJAwRA0rFhn0OIIfCDB8aE20XcaFJkLUwLgQgpqMimbSzReAHFm9eGLBoHgutZjJXxVETY027CPacK0DbItYAS2yCAcCU1TVxWCCQNO2dZbCz+y7fStlU0xFBKgCEj24TIkwLYOgC9TC4kJKiUgVpC1Um3uSRy+WLkeUQGWMrflnl2nCrIXfRAxRFhQGKDoCpiV5AWCgNLMRo77FhJqkVeqiAYlhKgAVJDcdGpNSTtQFO7Uc4jSwGzcqE0cqpuwtXf2JaG4NCMFzNu74diNDA5844kGwzmIpShuuegXZbxWYgRY94QT+248gXjdpWr2CqDhSw3RjELW4+VST-HpCCf4jtHKy7ySbHQDDPqF62CisQPlSDzRHDSxfcBQM4FNLaU9JGPSBl6DGXANAOA5l7Q4mshUuyqAHJaCcm+gSH6hJ8rEqrMzvALOKcWgwD0GhLM5Ws2pIMjJIZaXdDpJzfB9ISEMm50ynmLI+YQn54E9lHLctC5+iLPk6T5QS3wJLinTR2nOH+aKQHIagbiX3djm1oM5V3Gs2jBcBvyByvgJADNqBHpTZhSuRZIqrXWhx-a7dmPsn6xBobDhbBuJ8Dc3owKRL8vMdZpgNW3JhY8vV1WPWQOsYG1JqDAHostZUUIEbPYkDpGm0WObuCpoUdop9iz+AGhvm2MBg7qwcTSjeKdnKKthuGyuzd3laPPIQ9ax95rkOP3S1G4MCAgPZv5BB4tmavSixNeSl9qHjHYeQ3h0dzZJ3R6o4u-7THIXbt1Zx41wn+PsgACUCawH1iTv7Qmpf6wp4gYHC2Lxg6LJL259BLnSDJFQGsYIcFQR55F9HC0xFHY+Lkw2BSEfIFQ01frVTJ2IHvWrsQUANBHCQDDS9htGnO6QFgC9bvRQ6Z9370Uv7kZa1l0aOw2UpozcqPIHMoOlt06QEtFaC51uuyubtSEbch5I03JGE34lLvKVfYrO7X7Tc-pjWXyKAGyAtrkTwKgvERK4x9HwfQhIRmWrIHiYoLQUTWmAAAa0gDBxNnuSoO6ohntN80Fqt1lL0VZCgZ9rDBCVBo6VMYEEaIgJ+AB1QkjQzBrMIIoXQCgGFWgP5zcAwQ1rVkgwwGgqxgj8Fa6YKsCzOLh-GfCDDfDDINAABRpZ2bACHDMhizcAECoCKBvB0hUhBZ0ggFgEQEACU0IU0BAgwAA7ruqKH-mLAKGfEzKtNTIqjvpAOmr6EgLAQyPaNBBdHBIweTv6pCOAOQVNEwHWmXkwEgA-IUH3O-lMOVqXhkGdgtEwHQJZLoKoEYMANaGIYgGfOyBILABMs+EUAoJchsCXhrCdFwD2rdj+GyghJ7t7iltXjZqBOlvZtlo5hqHli5kZCZB5ihKVlZOVrZJVgFtVgLrylYd-gUNZPYcxDgC1CiAbF5EYTLtkHctLJoDoHoIYIgA-NwLYrwr2lNCIYWJFHuMABBgXAGn-DOOQcmPuLZIoDiumFWNmKjr3r4CIobMmMNGNORivthOLrUD6BAD-niAANJ2An4v5rykgNAkGKBT7MgIo0DWHD5NRMDB7oBiFMLq5IDWhiSAblCIALFUBLFqoMD1ACiKpkAwCcif6Fh0jHKyRaDFxYy3CMB5Kcy85lKID8615C7fp0h+QvGt6ih2Fe7ChML-Hvp1aRGjHREQlHA6y+ZyHuDRTpGo7aC6AKqIAwgQi2CyHmFKDFFVBf7xLMxZhFAFxEkdKZBTQ-jBB96xTmI9F9F7q1FtqVAlJ9xp407DhppUaGz4mQAG5mF0kLBLALhAEbCs6ElOC2S2BXDJwcY9gChxYppQAyZ8ZG7pLcb1zVhgATZcyRzcbpAcxk5vAcx2jmCK4Eo6m1BdY4owm1bhbtY9g4ieRPZ9bgaDbvbOlOHXbhF15PEOmemNbmZJZQ5gnJgumC5ulhl-gi6M5E5gAxl-GBlY4hnumda0DYEK40Bgnwk2HmKbEXo7Eex7F4kQj7RrjDyxoXHqnXHJJ3EjALwMB0iCJvEfE3Giho69mKSZnBmAkN6CpHSxr-r+xIlQkexxkREFBrGeTTkAZuSFAZHYnZFIDFBa4bCqjinCo5QlHAhlF1zAY0lN6aw1EJhcl9gzgak95MmdGsmICj7j6T6742wlECz9G06Cn9JNTbmqi7n2CmG0nCoKFIKfAABCuEXRC07ezMPE95FBlxywiqrZDxwInZj83ZkQyS-ZXxc5IZwu0eZek5iCC5URghiAZZHAiqVZRgXgYFMeiAAAFwUcYaEN-FCEwmJATE6VYjod3KoCWgKNKH6F8VWbqOoJef4gRb8bBnYl8ZbE4tJfzIsIulNE1u2Z8f4lWUtOmuLsso+DuBoFqPtOOWXgodsj8WUopUlPBg4rboBMpblOhjHMhjqn1NhobPyFcTObXBhTpdhcALhbpQ4vJWUkRSOQ1qRZrORQtNOYqtFeFsWYiR7pCSicxchHSMNFYGNNFDmY6bQNFLGUOQCQmR1sVY3pZZrC3mkbUOuVkbiSKd0LYKBReeFIeWSaUczPuJUdlbJRYpyc0TyW0aim5f2MhYycyXBRNb0T+QKZRv+ReK1TWB1bVeFK-rjB-pCCsYuaWVsRWeXAMbRGvh7HFVtYsEyT1VaJCJslOGqfUB0Mkr4IoKolaJbnaPwAcjuAdH5csNZShU2QFR7EFeSXSO8XhXJbZf4ilfdiRZ1Z0o-GCcvlTJCcleVbCalZRQiUuRlcidkC1KiE1TiTkYBfQDqO1WsINV1aSdQOSSefuOYOtueZtVssNdeTireQOAyR0f3s+a+SVO+bPizF+YsBzMoZEl1OodaIulWUKevlru9dTfuSxasTtetHdQWm0JBrAu9domJvDqYeLQ0FAXPM9QvqtBtMAHgSzp3HXIcb3P3HYPwLsUjWAAANxG2mCq0L5CK2DdzckABPjQytVNq4XgtwgwHFm2atVlCKc2hQMFpgc1-JNERYithsFQ+ycAxetNJwvtuUuEu1KOHsmaCIDt7QvAbkNF-tugTAIdxdLNn+Jw0dn1XgudVoShRhwATAQNCF3EXeyFZAANzZYNIA9xwVNQVAHwqgxNKIYVvZkVVi8N9esVHtCVF4aV1FZZ2x9Fp1mdK1C0l1Jwd4lNH1ayD1dQT1I9TUlgkADQb1VNxhX1Vwv1H6ndqFAoQNo939oNFs4NjxXZUN4VViK9Dia9D2Aqp9YAW9GxOqyAx1hsCtyYySb8BasyKIbEy8Mmk4q8eDqyzNpdJw74Nydyr9ZgDxPFVicIWCkhxhRdspyp0o849Qv9t+-lvZQDWFzxAUS9XxEDq9WNrpCNQJIJAUqNh0sRmNcsNFWZcJuNNhMRmV2Qj4jppNm51ZlS+AqtBd5e9Nb2DAJ5nQOj0AbN9ZZei1GdSA+JZjejHtChM1T5mCQtE+0+ot7Upti68YdRk1d5+1VFh16AN0yDiVh9zAdjcSLw-InMGg7yBQtwqAUjSV0JIj8Z92O9KjyJQAA)
+<https://italia.github.io/api-oas-checker/#text=PYBwpgdghiCWBcACAzAOgAyoEwChYQDNh4dFEA3MAJwGdZgIkAiTTARidMQBdZuAbMEgAiYArABGVWP35RuwaVwAeAWhoBXALZaoVAJ5IAkhAAmscrFMaoiWIlNjJ02fMX3N-HtWkLpwLkcaAGNpEF4GJAAfLjIAYjjEUXEpGTk-WBxYxABFDTAablsAQQAFI0RwKi0wbm4wRFtuDTr7c0QwQQhgvTBshv5gHv5YAC9R3rsHJ1TXDMqqAsheOwhEDQgAcl6oVGyTYH5uRcrqGrqGqC8qmgYry5b3cbcHewBzAt5F7MFVomqoKN6BB7PgOl1gsA9tkAKKbda8X5VYIACwAl6hMVx6tUaAB5AgAZWolmCQkQmxRdRANHgAHo6QoaKgwMooFoQIJUHxNlxIRAisFuCQyGQwLoZEgqMAJNQFAABers8xvPj3VBvYCUKgQKF8bLQGoiWAgPS8GoC4CIAAqVCgNH+uiBDAawlgqqKgmyGio-CQlOptIZ+F15EBwLAGq13O4vKKb1pOFUZEN5JAGgkIxoKNiQVCJoijEQAD5VNlShnM7AeohfvhHeGGB4NG0Zi50u4kyn2eTdNAPrmCvnwsCkKXy2daisoG8Rh0BW13p9YCdWyl224lMnEKmkFom35ByEwoWx2XRYgALIHxQz1VWxyyK2FF6P-ibMpGPY0EnURPJn0-UQKluBpek6RgWAWTZDlBDpRx1zSTdYDpch0ECIcT1HBZgGsIVgS7QCkHgtskIyVD0LIPMsMiaZKEGEALW4FR1CgMwJGAZQkGOfIcEhDkXQFRMyBCFFxXtEVRVKaVM3FSSLwAEkWAhmBAsCGSVLQVTVLkPRRDNuWAOlQEgSC6V0QpqBI8QQULZl9HZfg4jpfiQEE7gaDpUTxM86SZUELROAvZJnDIxQwCMUx5NFbh9HAJBCmkCA3myMgG2FdYW1MVLEF0ZQABlIDebgUSQZAADYcq0fBCuSkqysqi8yFNC4dX9ABtKBVFGdBVAATlUABdABvCqAF9eSa6ZjwLbDxymsh8s2KxllgcQel4cgrQ2CwhgfTppkQuZwr2KbWXZTlyQAdgAFjYNhgmQZArtULACD6rqboIcqJH6+7TFUUw2AkAAONgbrAKAbuCABWK7shC2YO0WaKyFi+LEBlAArMAhRyqBTHMQsrj8qpeAKJACCuH8csWABHFtFiixB2qsAAaRAX2aGgOY+QpwsGnKQGlMnYApnKyCsVGmqUsRmGc1z3M87yLLpRGNz8CLTCChauY0YSFrRuLyUS-AUsNsUIG0JBOtaLaOd1CBVHkTbgEFi2Ohgy6kBd3aJcQPnNeli90ZN44zf9sg8tq4rSpQXAPZanEi02TruuKVQAC1er6gAdVQAH1BoAakmi3qNm2ionPD3EEhcwyUQIxSmKaZZE2ZYGlRBpA9gEIGhkQ7QuOxZTtrgBxOcWlWxpp4XDbWy23UOhoH8TmkAhqEkGR7Cud9O7Hw3ztg8kmAAYQLmEbqurAdbIcewGAAApQk8QAOQAMUh5oUZy0OkGxrjZiU0CZE2BCTEWcoxa0kQFTfgNMpr00ZmAKK-tkyhzQQHR+5wDBC0gVQcmMDEAADIH7P1fp-b+PowCkygQUf2-9I48GNglcOyUmGQGtizL+8hqHuwWh8YAODDBMP-pjCQOM8YeyQSuFBNtQ4c0hIocw0B6g0H4YbUBfBwH8FoQQ6BlNqZ9ETvgwhwcmqMNrjFFhnM2HmysfOLh7VSjAHwNwDRFslFUBUfIcWDjmEYz0HafQTCLx5SMPULQMCE4OOqhACJ4pomhNFHwRJ5jDZiKtloWUVBkkXnSkgUwwAMxen8VHfAsAtBcNUGwEGlEyl5UqVw2p9SyDqzCosMh0sK4jirjXKaeRPjPm7rodYNBbByE5m4+0dBEAAE1iiXnyqcKgdchFuSoN8Q2dABS+x6ExAYDRhagGkLUAAB68dYaxgBvA+HUZ8kAJj+31pMGowQegghoNVS51AUFqlOdwM5h9rEY0AVIpqWjia6NMQY2BRjaZgAZrI1BU10HGxysmQRwiMU4VFvQqaxy8UGymgAHhJUgAAVGQl+78eE-xoTC-FC1CV0OJQtWWKkKQK3WUrLyIz7Rq1IiPMAZcLzH29gwmxdLqH+yxbUAw6SAnkhcW4phXifFqJtogG67AsDIA5uDVAbA9UeIvCy-RfiLZS0QLde6j1nqvXep9b6v0+r-UBsDMGEMoaw3hh7PWMDfZbSYYHcKSAL5XxvgjIVyNYBdL-jYsFwCmo9NPIgAAqtc25U4rTUsJAwRA0rFhn0OIIfCDB8aE20XcaFJkLUwLgQgpqMimbSzReAHFm9eGLBoHgutZjJXxVETY027CPacK0DbItYAS2yCAcCU1TVxWCCQNO2dZbCz+y7fStlU0xFBKgCEj24TIkwLYOgC9TC4kJKiUgVpC1Um3uSRy+WLkeUQGWMrflnl2nCrIXfRAxRFhQGKDoCpiV5AWCgNLMRo77FhJqkVeqiAYlhKgAVJDcdGpNSTtQFO7Uc4jSwGzcqE0cqpuwtXf2JaG4NCMFzNu74diNDA5844kGwzmIpShuuegXZbxWYgRY94QT+248gXjdpWr2CqDhSw3RjELW4+VST-HpCCf4jtHKy7ySbHQDDPqF62CisQPlSDzRHDSxfcBQM4FNLaU9JGPSBl6DGXANAOA5l7Q4mshUuyqAHJaCcm+gSH6hJ8rEqrMzvALOKcWgwD0GhLM5Ws2pIMjJIZaXdDpJzfB9ISEMm50ynmLI+YQn54E9lHLctC5+iLPk6T5QS3wJLinTR2nOH+aKQHIagbiX3djm1oM5V3Gs2jBcBvyByvgJADNqBHpTZhSuRZIqrXWhx-a7dmPsn6xBobDhbBuJ8Dc3owKRL8vMdZpgNW3JhY8vV1WPWQOsYG1JqDAHostZUUIEbPYkDpGm0WObuCpoUdop9iz+AGhvm2MBg7qwcTSjeKdnKKthuGyuzd3laPPIQ9ax95rkOP3S1G4MCAgPZv5BB4tmavSixNeSl9qHjHYeQ3h0dzZJ3R6o4u-7THIXbt1Zx41wn+PsgACUCawH1iTv7Qmpf6wp4gYHC2Lxg6LJL259BLnSDJFQGsYIcFQR55F9HC0xFHY+Lkw2BSEfIFQ01frVTJ2IHvWrsQUANBHCQDDS9htGnO6QFgC9bvRQ6Z9370Uv7kZa1l0aOw2UpozcqPIHMoOlt06QEtFaC51uuyubtSEbch5I03JGE34lLvKVfYrO7X7Tc-pjWXyKAGyAtrkTwKgvERK4x9HwfQhIRmWrIHiYoLQUTWmAAAa0gDBxNnuSoO6ohntN80Fqt1lL0VZCgZ9rDBCVBo6VMYEEaIgJ+AB1QkjQzBrMIIoXQCgGFWgP5zcAwQ1rVkgwwGgqxgj8Fa6YKsCzOLh-GfCDDfDDINAABRpZ2bACHDMhizcAECoCKBvB0hUhBZ0ggFgEQEACU0IU0BAgwAA7ruqKH-mLAKGfEzKtNTIqjvpAOmr6EgLAQyPaNBBdHBIweTv6pCOAOQVNEwHWmXkwEgA-IUH3O-lMOVqXhkGdgtEwHQJZLoKoEYMANaGIYgGfOyBILABMs+EUAoJchsCXhrCdFwD2rdj+GyghJ7t7iltXjZqBOlvZtlo5hqHli5kZCZB5ihKVlZOVrZJVgFtVgLrylYd-gUNZPYcxDgC1CiAbF5EYTLtkHctLJoDoHoIYIgA-NwLYrwr2lNCIYWJFHuMABBgXAGn-DOOQcmPuLZIoDiumFWNmKjr3r4CIobMmMNGNORivthOLrUD6BAD-niAANJ2An4v5rykgNAkGKBT7MgIo0DWHD5NRMDB7oBiFMLq5IDWhiSAblCIALFUBLFqoMD1ACiKpkAwCcif6Fh0jHKyRaDFxYy3CMB5Kcy85lKID8615C7fp0h+QvGt6ih2Fe7ChML-Hvp1aRGjHREQlHA6y+ZyHuDRTpGo7aC6AKqIAwgQi2CyHmFKDFFVBf7xLMxZhFAFxEkdKZBTQ-jBB96xTmI9F9F7q1FtqVAlJ9xp407DhppUaGz4mQAG5mF0kLBLALhAEbCs6ElOC2S2BXDJwcY9gChxYppQAyZ8ZG7pLcb1zVhgATZcyRzcbpAcxk5vAcx2jmCK4Eo6m1BdY4owm1bhbtY9g4ieRPZ9bgaDbvbOlOHXbhF15PEOmemNbmZJZQ5gnJgumC5ulhl-gi6M5E5gAxl-GBlY4hnumda0DYEK40Bgnwk2HmKbEXo7Eex7F4kQj7RrjDyxoXHqnXHJJ3EjALwMB0iCJvEfE3Giho69mKSZnBmAkN6CpHSxr-r+xIlQkexxkREFBrGeTTkAZuSFAZHYnZFIDFBa4bCqjinCo5QlHAhlF1zAY0lN6aw1EJhcl9gzgak95MmdGsmICj7j6T6742wlECz9G06Cn9JNTbmqi7n2CmG0nCoKFIKfAABCuEXRC07ezMPE95FBlxywiqrZDxwInZj83ZkQyS-ZXxc5IZwu0eZek5iCC5URghiAZZHAiqVZRgXgYFMeiAAAFwUcYaEN-FCEwmJATE6VYjod3KoCWgKNKH6F8VWbqOoJef4gRb8bBnYl8ZbE4tJfzIsIulNE1u2Z8f4lWUtOmuLsso+DuBoFqPtOOWXgodsj8WUopUlPBg4rboBMpblOhjHMhjqn1NhobPyFcTObXBhTpdhcALhbpQ4vJWUkRSOQ1qRZrORQtNOYqtFeFsWYiR7pCSicxchHSMNFYGNNFDmY6bQNFLGUOQCQmR1sVY3pZZrC3mkbUOuVkbiSKd0LYKBReeFIeWSaUczPuJUdlbJRYpyc0TyW0aim5f2MhYycyXBRNb0T+QKZRv+ReK1TWB1bVeFK-rjB-pCCsYuaWVsRWeXAMbRGvh7HFVtYsEyT1VaJCJslOGqfUB0Mkr4IoKolaJbnaPwAcjuAdH5csNZShU2QFR7EFeSXSO8XhXJbZf4ilfdiRZ1Z0o-GCcvlTJCcleVbCalZRQiUuRlcidkC1KiE1TiTkYBfQDqO1WsINV1aSdQOSSefuOYOtueZtVssNdeTireQOAyR0f3s+a+SVO+bPizF+YsBzMoZEl1OodaIulWUKevlru9dTfuSxasTtetHdQWm0JBrAu9domJvDqYeLQ0FAXPM9QvqtBtMAHgSzp3HXIcb3P3HYPwLsUjWAAANxG2mCq0L5CK2DdzckABPjQytVNq4XgtwgwHFm2atVlCKc2hQMFpgc1-JNERYithsFQ+ycAxetNJwvtuUuEu1KOHsmaCIDt7QvAbkNF-tugTAIdxdLNn+Jw0dn1XgudVoShRhwATAQNCF3EXeyFZAANzZYNIA9xwVNQVAHwqgxNKIYVvZkVVi8N9esVHtCVF4aV1FZZ2x9Fp1mdK1C0l1Jwd4lNH1ayD1dQT1I9TUlgkADQb1VNxhX1Vwv1H6ndqFAoQNo939oNFs4NjxXZUN4VViK9Dia9D2Aqp9YAW9GxOqyAx1hsCtyYySb8BasyKIbEy8Mmk4q8eDqyzNpdJw74Nydyr9ZgDxPFVicIWCkhxhRdspyp0o849Qv9t+-lvZQDWFzxAUS9XxEDq9WNrpCNQJIJAUqNh0sRmNcsNFWZcJuNNhMRmV2Qj4jppNm51ZlS+AqtBd5e9Nb2DAJ5nQOj0AbN9ZZei1GdSA+JZjejHtChM1T5mCQtE+0+ot7Upti68YdRk1d5+1VFh16AN0yDiVh9zAdjcSLw-InMGg7yBQtwqAUjSV0JIj8Z92O9KjyJQAA>

connexion-101/025-openapi-3.md

@@ -15,7 +15,7 @@ participated by government & companies
 (gov.uk, Microsoft, Google, Oracle, IBM, ..):
 
 - Driver for API adoption
-- Evolution of Swagger 2.0
+- ~Evolution of Swagger 2.0~
 - Lightweight format: YAML or JSON
 - Generates docs & code via tools (e.g., [swagger-editor](https://editor.swagger.io))
 - Allows reusable components via hyperlink (eg. `$ref`)
@@ -27,6 +27,7 @@ This workshop is based on 3.0, but the most significant
 changes in 3.1 and 4.0 are about the support of JSON Schema,
 so they don't affect the basics of API modeling.
 
+---
 
 ## OpenAPI Editor
 
@@ -36,7 +37,7 @@ Every OAS3 document begins with
 openapi: 3.0.0
 ```
 
-[Swagger Editor](https://editor.swagger.io/?url=https://raw.githubusercontent.com/teamdigitale/api-starter-kit/master/openapi/simple.yaml.src) is a simple webapp for editing OpenAPI 3 language specs.
+[Swagger Editor](https://editor.swagger.io/?url=https://raw.githubusercontent.com/teamdigitale/api-starter-kit/master/openapi/simple.yaml.src) is a simple webapp for editing OAS3 language specs.
 
 The Italian Govenment built a couple of tools that help implementing interoperable APIs
 (disclaimer: I authored the tools when I worked there):
@@ -108,7 +109,7 @@ info:
 
 1. Feel free to add as many details as you want.
 
-1. Save it back to your local notebook.
+1. Save it back to your local notebook' `openapi.yaml`.
 
 ----
 
@@ -151,9 +152,9 @@ achine readable format
 
 ## OpenAPI Metadata exercise: 2
 
-1. open [the previous OAS3 spec](/edit/notebooks/oas3/ex-01-info.yaml).
+1. open the previous OAS3 spec [ex-01-info](/edit/notebooks/oas3/ex-01-info.yaml).
 
-1. copy its content in the [Swagger Editor Online](https://editor.swagger.io) and try to use it.
+1. copy its content in the [Swagger Editor Online](https://editor.swagger.io) and look for issues.
 
 1. provide further informations via custom fields: if you think of any interesting
    label, define them and comment properly using `#`

connexion-101/039-schema-semantics.md

@@ -44,6 +44,33 @@ components:
 
 ----
 
+```mermaid
+graph
+
+subgraph PersonIT
+nome
+cognome
+end
+
+
+
+subgraph semantic-context
+Person((Person))
+givenName & familyName -.->|domain| Person
+end
+
+PersonIT -.->|is-a| Person
+PersonEN -.->|is-a| Person
+nome -.->|is-a| givenName
+cognome -.->|is-a| familyName
+name -.->|is-a| givenName
+surname -.->|is-a| familyName
+subgraph PersonEN
+name
+surname
+end
+```
+
 ### Why this matters
 
 - APIs from different organizations can share data without sharing schemas.

connexion-101/080-connexion-pagination.md

@@ -1,4 +1,4 @@
-# Pagination and encapsulation:
+# Pagination and encapsulation
 
 In our standardization policy, we defined a common set of pagination parameters.
 
@@ -7,7 +7,12 @@ Moreover we stated that responses should always be enclosed in json objects, eg:
 * always return something that is extensible like
 
 ```http
-GET /timezones
+GET /timezones HTTP/1.1
+Host: 127.0.0.1
+
+
+HTTP/1.1 200 OK
+Content-Type: application/json
 
 {
  "entries": [ "you", "can", "always", "add", "new", "keys" ]
@@ -18,11 +23,22 @@ GET /timezones
 * don't return `string`, `number` or `array`, because
 
 ```http
-GET /dont-do-this
+GET /dont-do-this HTTP/1.1
+Host: 127.0.0.1
+Content-Type: application/json
+
+
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+[
+ "you can't",
+ "extend them"
+]
 
-[ "you can't", "extend them"]
 ```
 
+
 ---
 
 ## Support pagination in `get /timezones`