Phil Davis<p>AsyncAPI: Any folks with experience documenting non-RESTful APIs and other async message protocols?</p><p>Any tips or advice?</p><p>I'm having way too much fun in Redocly's beta sandbox.</p><p>I've got a bit of experience with OpenAPI/Swagger/REST so I'm mostly worried about "false friend" equivalencies and gotchas.</p><p>I'm also excited about bringing some APIs out of the Stone Age of pages of PDF tables.</p><p><a href="https://mastodon.nz/tags/apiDoc" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>apiDoc</span></a> <a href="https://mastodon.nz/tags/apiDocumentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>apiDocumentation</span></a> <a href="https://mastodon.nz/tags/redocly" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>redocly</span></a> <a href="https://mastodon.nz/tags/technicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>technicalWriting</span></a> <a href="https://mastodon.nz/tags/documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>documentation</span></a> <a href="https://mastodon.nz/tags/techWriterLife" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>techWriterLife</span></a> <a href="https://mastodon.nz/tags/asyncAPI" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>asyncAPI</span></a></p>
Recent searches
No recent searches
Search options
Only available when logged in.
social.tchncs.de is one of the many independent Mastodon servers you can use to participate in the fediverse.
A friendly server from Germany – which tends to attract techy people, but welcomes everybody. This is one of the oldest Mastodon instances.
Administered by:
Server stats:
3.8Kactive users
social.tchncs.de: About · Profiles directory · Privacy policy
Mastodon: About · Get the app · Keyboard shortcuts · View source code · v4.3.7
#apidoc
0 posts · 0 participants · 0 posts today
Paul Goble :base:<p><a href="https://qoto.org/tags/Introduction" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Introduction</span></a></p><p>I'm Paul Goble in Nebraska & Colorado, USA. </p><p><a href="https://qoto.org/tags/NotMe" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>NotMe</span></a>: Childrens author, Eurasian expert</p><p>Values: <a href="https://qoto.org/tags/LoveGod" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>LoveGod</span></a> <a href="https://qoto.org/tags/LovePeople" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>LovePeople</span></a> <a href="https://qoto.org/tags/truthmatters" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>truthmatters</span></a> <a href="https://qoto.org/tags/CovidIsNotOver" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>CovidIsNotOver</span></a></p><p>Work: Technical writer <a href="https://qoto.org/tags/techcomm" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>techcomm</span></a> <a href="https://qoto.org/tags/scicomm" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>scicomm</span></a> <a href="https://qoto.org/tags/icpms" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>icpms</span></a> <a href="https://qoto.org/tags/spectroscopy" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>spectroscopy</span></a> <a href="https://qoto.org/tags/uxdesign" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>uxdesign</span></a> <a href="https://qoto.org/tags/apidoc" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>apidoc</span></a> <a href="https://qoto.org/tags/instrumentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>instrumentation</span></a> </p><p>Interests: <a href="https://qoto.org/tags/physics" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>physics</span></a> <a href="https://qoto.org/tags/linguistics" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>linguistics</span></a> <a href="https://qoto.org/tags/risks" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>risks</span></a> <a href="https://qoto.org/tags/lighting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>lighting</span></a> <a href="https://qoto.org/tags/VisualArts" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>VisualArts</span></a> <a href="https://qoto.org/tags/nature" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>nature</span></a> <a href="https://qoto.org/tags/ChristianFiction" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>ChristianFiction</span></a> <a href="https://qoto.org/tags/libraries" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>libraries</span></a> <a href="https://qoto.org/tags/meteorology" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>meteorology</span></a> </p><p>Play: <a href="https://qoto.org/tags/violin" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>violin</span></a> <a href="https://qoto.org/tags/recorder" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>recorder</span></a></p><p>Orgs: <a href="https://qoto.org/tags/ieee" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>ieee</span></a>-pcs <a href="https://qoto.org/tags/acm" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>acm</span></a> <a href="https://qoto.org/tags/sigdoc" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>sigdoc</span></a> <a href="https://qoto.org/tags/stc" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>stc</span></a></p><p>Pronouns: Talk to me, not about me.</p><p>Mastodon accounts:<br><span class="h-card"><a href="https://vis.social/@pgcommunication" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>pgcommunication</span></a></span> for visual and technical communication.<br><span class="h-card"><a href="https://qoto.org/@pgcommunication" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>pgcommunication</span></a></span> for everything else.</p>
Phil Davis<p>Everyone is looking to me for API doc best practices and process. Validating, but also a little intimidating, like the teacher learning the content the night before to stay ahead of the API doc class while teaching seven other classes at the same time.</p><p>I'd appreciate y'all sharing any thoughts & references & resources, from theory to implementation.</p><p><a href="https://mastodon.nz/tags/technicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>technicalWriting</span></a> <a href="https://mastodon.nz/tags/techWriterLife" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>techWriterLife</span></a> <a href="https://mastodon.nz/tags/writeTheDocs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>writeTheDocs</span></a> <a href="https://mastodon.nz/tags/loneWriter" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>loneWriter</span></a> <a href="https://mastodon.nz/tags/apiDoc" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>apiDoc</span></a> <a href="https://mastodon.nz/tags/apiDocs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>apiDocs</span></a> <a href="https://mastodon.nz/tags/apiDocumentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>apiDocumentation</span></a></p>
pgcommunication<p>I'm Paul Goble in Nebraska & Colorado, USA. I care about you. </p><p><a href="https://vis.social/tags/NotMe" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>NotMe</span></a>: Childrens author, Eurasian expert</p><p>Values: <a href="https://vis.social/tags/LoveGod" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>LoveGod</span></a> <a href="https://vis.social/tags/LovePeople" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>LovePeople</span></a> <a href="https://vis.social/tags/truthmatters" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>truthmatters</span></a> <a href="https://vis.social/tags/CovidIsNotOver" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>CovidIsNotOver</span></a></p><p>Work: Technical writer <a href="https://vis.social/tags/techcomm" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>techcomm</span></a> <a href="https://vis.social/tags/scicomm" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>scicomm</span></a> <a href="https://vis.social/tags/icpms" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>icpms</span></a> <a href="https://vis.social/tags/spectroscopy" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>spectroscopy</span></a> <a href="https://vis.social/tags/uxdesign" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>uxdesign</span></a> <a href="https://vis.social/tags/apidoc" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>apidoc</span></a> <a href="https://vis.social/tags/instrumentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>instrumentation</span></a> </p><p>Interests: <a href="https://vis.social/tags/physics" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>physics</span></a> <a href="https://vis.social/tags/linguistics" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>linguistics</span></a> <a href="https://vis.social/tags/risks" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>risks</span></a> <a href="https://vis.social/tags/lighting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>lighting</span></a> <a href="https://vis.social/tags/VisualArts" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>VisualArts</span></a> <a href="https://vis.social/tags/nature" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>nature</span></a> <a href="https://vis.social/tags/ChristianFiction" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>ChristianFiction</span></a> <a href="https://vis.social/tags/libraries" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>libraries</span></a> <a href="https://vis.social/tags/meteorology" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>meteorology</span></a> Play <a href="https://vis.social/tags/violin" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>violin</span></a> <a href="https://vis.social/tags/recorder" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>recorder</span></a></p><p>Orgs: <a href="https://vis.social/tags/ieee" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>ieee</span></a>-pcs <a href="https://vis.social/tags/acm" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>acm</span></a> <a href="https://vis.social/tags/sigdoc" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>sigdoc</span></a> <a href="https://vis.social/tags/stc" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>stc</span></a></p><p>Pronouns: Talk to me, not about me.</p><p><a href="https://vis.social/tags/introduction" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>introduction</span></a></p>
ExploreLive feeds
Mastodon is the best way to keep up with what's happening.
Follow anyone across the fediverse and see it all in chronological order. No algorithms, ads, or clickbait in sight.
Create accountLoginDrag & drop to upload