-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
7 changed files
with
40 additions
and
6 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -142,4 +142,6 @@ | |
</span></span><span style=display:flex><span><span style=color:#bd93f9>20</span> | x-aviskase-enum: | ||
</span></span><span style=display:flex><span> | ||
</span></span><span style=display:flex><span>Error was generated by the custom-rules/description-style rule. | ||
</span></span></code></pre></div><p>Hmm, looks confusing. Thanks to <code>suggest</code> we can at least see that something was added to the original description… Oh, right, that was our preprocessor! That’s why I suggested to use it in the first place: if we were to modify descriptions via decorators, the rule wouldn’t be able to catch this problem.</p><p>Finally, to make linter passing, we need to fix the preprocessor plugin code <a href=https://github.com/aviskase/openapi-cli-examples/tree/81a43321ae607fd20afd5abe4922fc86fa0fcce0 class=external>commit 81a4332</a>.</p><div class="admonition cta"><div class=admonition-icon><svg xmlns="http://www.w3.org/2000/svg" width="28" height="28" fill="none" viewBox="0 0 24 24" stroke="currentcolor"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9.663 17h4.673M12 3v1m6.364 1.636-.707.707M21 12h-1M4 12H3m3.343-5.657-.707-.707m2.828 9.9a5 5 0 117.072.0l-.548.547A3.374 3.374.0 0014 18.469V19a2 2 0 11-4 0v-.531c0-.895-.356-1.754-.988-2.386l-.548-.547z"/></svg></div><p>Rules are cooler than preprocessors and decorators: they support nested visitors. I’ll cover this concept in the next article. Until then, try to come up with an example where the uppercase rule in its current form might have undesired behavior.</p></div></article><div class=page-navigation><a class=prev href=https://www.aviskase.com/articles/2021/08/16/using-openapi-cli-custom-preprocessing/ title="Using `openapi-cli`: custom preprocessing"><svg xmlns="http://www.w3.org/2000/svg" width="1em" height="1em" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M11 17l-5-5 5-5m7 10-5-5 5-5"/></svg>older</a></div></main><footer class="justify-center flex w-full pt-6 pb-4 text-16 bg-amber-300 mt-12"><a class="border-b-2 border-transparent hover:border-blue-500" href=mailto:[email protected]>Yuliya Bagriy</a><span> · 2023 · </span><a class="border-b-2 border-transparent hover:border-blue-500" href=https://www.aviskase.com/pages/i-dont-track-you/>No tracking</a></footer></div></body></html> | ||
</span></span></code></pre></div><p>Hmm, looks confusing. Thanks to <code>suggest</code> we can at least see that something was added to the original description… Oh, right, that was our preprocessor! That’s why I suggested to use it in the first place: if we were to modify descriptions via decorators, the rule wouldn’t be able to catch this problem.</p><p>Finally, to make linter passing, we need to fix the preprocessor plugin code <a href=https://github.com/aviskase/openapi-cli-examples/tree/81a43321ae607fd20afd5abe4922fc86fa0fcce0 class=external>commit 81a4332</a>.</p><div class="admonition cta"><div class=admonition-icon><svg xmlns="http://www.w3.org/2000/svg" width="28" height="28" fill="none" viewBox="0 0 24 24" stroke="currentcolor"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9.663 17h4.673M12 3v1m6.364 1.636-.707.707M21 12h-1M4 12H3m3.343-5.657-.707-.707m2.828 9.9a5 5 0 117.072.0l-.548.547A3.374 3.374.0 0014 18.469V19a2 2 0 11-4 0v-.531c0-.895-.356-1.754-.988-2.386l-.548-.547z"/></svg></div><p>Rules are cooler than preprocessors and decorators: they support nested visitors. I’ll cover this concept in the next article. Until then, try to come up with an example where the uppercase rule in its current form might have undesired behavior.</p></div></article><div class=page-navigation><a class=prev href=https://www.aviskase.com/articles/2021/08/16/using-openapi-cli-custom-preprocessing/ title="Using `openapi-cli`: custom preprocessing"><svg xmlns="http://www.w3.org/2000/svg" width="1em" height="1em" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M11 17l-5-5 5-5m7 10-5-5 5-5"/></svg>older</a> | ||
<span class=separator> · · · </span> | ||
<a class=next href=https://www.aviskase.com/articles/2023/12/15/the-navys-it-challenges/ title="The Navy's IT challenges">newer<svg xmlns="http://www.w3.org/2000/svg" width="1em" height="1em" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M13 17l5-5-5-5M6 17l5-5-5-5"/></svg></a></div></main><footer class="justify-center flex w-full pt-6 pb-4 text-16 bg-amber-300 mt-12"><a class="border-b-2 border-transparent hover:border-blue-500" href=mailto:[email protected]>Yuliya Bagriy</a><span> · 2023 · </span><a class="border-b-2 border-transparent hover:border-blue-500" href=https://www.aviskase.com/pages/i-dont-track-you/>No tracking</a></footer></div></body></html> |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,10 @@ | ||
<!doctype html><html lang=en prefix="og: http://ogp.me/ns# article: http://ogp.me/ns/article# profile: http://ogp.me/ns/profile#"><head><title>aviskase</title> | ||
<meta name=viewport content="width=device-width,initial-scale=1"><meta charset=utf-8><meta property="og:title" content="The Navy’s IT challenges"><meta property="og:description" content="Can’t stop thinking about one line from the recent Paul Well’s interview with Vice Admiral Angus Topshee, the Commander of the Royal Canadian Navy. | ||
PW: Is the fact that this video’s on YouTube a reflection of any difficulty you’re having getting heard internally? | ||
AT: No. I’ve shared my assessments with the leadership of the Department, up to and including this minister and the previous Minister."><meta name=description content="Can’t stop thinking about one line from the recent Paul Well’s interview with Vice Admiral Angus Topshee, the Commander of the Royal Canadian Navy. | ||
PW: Is the fact that this video’s on YouTube a reflection of any difficulty you’re having getting heard internally? | ||
AT: No. I’ve shared my assessments with the leadership of the Department, up to and including this minister and the previous Minister."><meta property="og:url" content="https://www.aviskase.com/articles/2023/12/15/the-navys-it-challenges/"><link rel=canonical href=https://www.aviskase.com/articles/2023/12/15/the-navys-it-challenges/><meta property="og:type" content="article"><meta property="og:image" content="https://www.aviskase.com/articles/2023/12/15/the-navys-it-challenges/feature.png"><meta property="og:image:height" content="630"><meta property="og:image:width" content="1200"><meta property="article:published_time" content="2023-12-15T00:10:48-05:00"><meta property="article:modified_time" content="2023-12-15T00:10:48-05:00"><meta property="og:site_name" content="aviskase"><meta property="article:author" content="https://www.aviskase.com/pages/about/"><meta name=twitter:card content="summary_large_image"><meta name=twitter:image content="https://www.aviskase.com/articles/2023/12/15/the-navys-it-challenges/feature.png"><meta name=twitter:title content="The Navy's IT challenges"><meta name=twitter:description content="Can’t stop thinking about one line from the recent Paul Well’s interview with Vice Admiral Angus Topshee, the Commander of the Royal Canadian Navy. | ||
PW: Is the fact that this video’s on YouTube a reflection of any difficulty you’re having getting heard internally? | ||
AT: No. I’ve shared my assessments with the leadership of the Department, up to and including this minister and the previous Minister."><meta name=twitter:site content="@aviskase"><meta name=generator content="Hugo 0.121.1"><link rel=stylesheet href="/css/main.min.2e7af902202084f9ac7b62b2d0d18bd8684be837e27b45bde4d2c3442d7b518b.css" integrity="sha256-Lnr5AiAghPmse2Ky0NGL2GhL6Dfie0W95NLDRC17UYs="></head><body><div class="min-h-screen grid grid-rows-mainLayout"><header><nav class="bg-gradient-to-b from-blue-800 to-sky-600 relative lowercase"><div class="pb-12 pt-6 max-w-normal flex flex-wrap items-center normal:items-baseline justify-between mx-6 normal:mx-auto"><a class="text-amber-300 font-bold text-24" href=/>aviskase</a> | ||
<input id=nav-toggle type=checkbox> | ||
<label id=show-button for=nav-toggle class="flex items-center normal:hidden"><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" class="w-12 h-12 stroke-amber-300"><title>Menu Open</title><path stroke-linecap="round" stroke-linejoin="round" d="M3.75 6.75h16.5M3.75 12h16.5m-16.5 5.25h16.5"/></svg></label><label id=hide-button for=nav-toggle class="items-center hidden"><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" class="w-12 h-12 stroke-amber-300"><title>Menu Close</title><path stroke-linecap="round" stroke-linejoin="round" d="M6 18 18 6M6 6l12 12"/></svg></label><ul id=nav-menu class="font-semibold text-16 text-white hidden normal:flex mt-3 normal:mt-0 space-y-3 normal:space-y-0 normal:space-x-4.5 w-full normal:w-auto"><li><a href=/>Home</a></li><li><a href=/pages/about/>About</a></li><li><a href=/pages/archive/>Archive</a></li><li><a href=/feeds/all.atom.xml>RSS</a></li></ul></div><div class=shape-divider><svg data-name="Layer 1" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 120" preserveAspectRatio="none"><path d="M0 0V46.29c47.79 22.2 103.59 32.17 158 28 70.36-5.37 136.33-33.31 206.8-37.5C438.64 32.43 512.34 53.67 583 72.05c69.27 18 138.3 24.88 209.4 13.08 36.15-6 69.85-17.84 104.45-29.34C989.49 25 1113-14.29 12e2 52.47V0z" opacity=".25" class="shape-fill"/><path d="M0 0V15.81C13 36.92 27.64 56.86 47.69 72.05 99.41 111.27 165 111 224.58 91.58c31.15-10.15 60.09-26.07 89.67-39.8 40.92-19 84.73-46 130.83-49.67 36.26-2.85 70.9 9.42 98.6 31.56 31.77 25.39 62.32 62 103.63 73 40.44 10.79 81.35-6.69 119.13-24.28s75.16-39 116.92-43.05c59.73-5.85 113.28 22.88 168.9 38.84 30.2 8.66 59 6.17 87.09-7.5 22.43-10.89 48-26.93 60.65-49.24V0z" opacity=".5" class="shape-fill"/><path d="M0 0V5.63C149.93 59 314.09 71.32 475.83 42.57c43-7.64 84.23-20.12 127.61-26.46 59-8.63 112.48 12.24 165.56 35.4C827.93 77.22 886 95.24 951.2 90c86.53-7 172.46-45.71 248.8-84.81V0z" class="shape-fill"/></svg></div></nav></header><main><div class=title-hero><h1>The Navy’s IT challenges</h1><div class=article-meta><div class=normal:justify-self-end>15 Dec 2023</div><div class="hidden normal:block"> — </div><div class="relative normal:justify-self-start"><svg class="inline relative" xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><polyline points="12 6 12 12 16 14"/></svg><span> 2 mins</span></div></div></div><article><p>Can’t stop thinking about one line from the recent <a href=https://paulwells.substack.com/p/a-generational-challenge-in-naval class=external>Paul Well’s interview with Vice Admiral Angus Topshee</a>, the Commander of the Royal Canadian Navy.</p><blockquote><p>PW: Is the fact that this video’s on YouTube a reflection of any difficulty you’re having getting heard internally?</p><p>AT: No. I’ve shared my assessments with the leadership of the Department, up to and including this minister and the previous Minister. I feel I’m being heard and respected. This was more about, we wanted to put the message out internally. Unfortunately, there’s some very specific IT challenges around how we disseminate internal messages. And so [Youtube] was the channel we used.</p></blockquote><p><em>Specific IT challenges</em>, eh?</p><p>I guess most of the people skim through this line. Whatever, it’s just a pretext. But for me it sounds bizarrely specific. So, here some of my musings about it.</p><p>Those problems with internal communications. It got me curious, how really it’s even done in the military. “Army-wide” emails? Slack, Zoom, Teams? IRC? The answer is <a href=https://www.reddit.com/r/CanadianForces/comments/11hy76u/scs_whaaaatsappp/ class=external>all of these</a>. Total chaos. I especially like the comment mentioning using Facebook Messenger, because, c’mon! At least, no WeChat. I hope. I also hope they have less problems accessing their Top Secret Network stuff, <a href=https://www.canada.ca/content/dam/di-id/documents/rpt/rapporteur/Independent-Special-Rapporteur%20-Report-eng.pdf class=external>not like our ministers [page 27]</a>.</p><p>While we already established that, in fact, it’s way easier to just publicly share YouTube video than send a file or a private link, I highly doubt it was the main reason. Thus, I wonder, why IT was selected as a pretext. Why. Is it something on admiral’s mind? Or is it a common “enemy” that always gets blamed and everyone nods understandingly? Is IT a dog that ate the homework in government offices? 🙄</p><hr><p>Yeah, I’m back. Kinda. No promises.</p></article><div class=page-navigation><a class=prev href=https://www.aviskase.com/articles/2021/09/06/using-openapi-cli-custom-rules/ title="Using `openapi-cli`: custom rules"><svg xmlns="http://www.w3.org/2000/svg" width="1em" height="1em" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M11 17l-5-5 5-5m7 10-5-5 5-5"/></svg>older</a></div></main><footer class="justify-center flex w-full pt-6 pb-4 text-16 bg-amber-300 mt-12"><a class="border-b-2 border-transparent hover:border-blue-500" href=mailto:[email protected]>Yuliya Bagriy</a><span> · 2023 · </span><a class="border-b-2 border-transparent hover:border-blue-500" href=https://www.aviskase.com/pages/i-dont-track-you/>No tracking</a></footer></div></body></html> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.