Skip to content

Commit

Permalink
Updates
Browse files Browse the repository at this point in the history
  • Loading branch information
kalinchernev committed Jan 22, 2024
1 parent 1072130 commit 7f256b3
Show file tree
Hide file tree
Showing 148 changed files with 154 additions and 154 deletions.
2 changes: 1 addition & 1 deletion 404.html

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion 404/index.html

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion admin-ui-gatsby-static-site-generator/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -116,4 +116,4 @@ <h3 id="gatsby" style="position:relative;"><a href="#gatsby" aria-label="gatsby
<p>Check if all works, and if yes, make another deployment to the your repository. I personally removed all the unnecessary content manually and had to flush the cache of the last deploy in the console.</p>
<h3 id="the-result" style="position:relative;"><a href="#the-result" aria-label="the result permalink" class="anchor before"><svg aria-hidden="true" focusable="false" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>The result</h3>
<p>You have a modern tool-chain of React, GraphQL, webpack, and similar, called Gatsby, and you have a working administration UI to manage your content when you’re lazy to open your editor ;)</p>
<p>Here’s a <a href="https://github.com/kalinchernev/kalinchernev.github.io/blob/blog/static/videos/netlify-cms-gatsby.mp4" target="_blank" rel="nofollow noopener noreferrer">video of the process</a> from making a draft which is a pull request, opening a preview and then publishing the change which gets automatically deployed on the site.</p></div></div></div><div class="Post-module--footer--f8705"><div class="Meta-module--meta--dae0a"><p class="Meta-module--date--4d30d">Published<!-- --> <!-- -->Aug 17, 2017</p></div><div class="Tags-module--tags--18589"><ul class="Tags-module--list--82ae6"><li class="Tags-module--item--52015"><a class="Button-module--button--b1113" href="/tag/jamstack/">JAMStack</a></li><li class="Tags-module--item--52015"><a class="Button-module--button--b1113" href="/tag/javascript/">JavaScript</a></li><li class="Tags-module--item--52015"><a class="Button-module--button--b1113" href="/tag/gatsbyjs/">GatsbyJS</a></li></ul></div><div class="Author-module--author--1c58d"><p class="Author-module--bio--08950">Writing crystallizes thought and thought produces action.<a class="Author-module--twitter--90647" href="https://www.twitter.com/kalinchernev" rel="noopener noreferrer" target="_blank"><strong>Kalin Chernev</strong> on Twitter</a></p></div></div><div class="Post-module--comments--d3b99"><div id="disqus_thread"></div></div></div></div></div><div id="gatsby-announcer" style="position:absolute;top:0;width:1px;height:1px;padding:0;overflow:hidden;clip:rect(0, 0, 0, 0);white-space:nowrap;border:0" aria-live="assertive" aria-atomic="true"></div></div><script id="gatsby-script-loader">/*<![CDATA[*/window.pagePath="/admin-ui-gatsby-static-site-generator";window.___webpackCompilationHash="11630d3d901a5c2c7fa5";/*]]>*/</script><script id="gatsby-chunk-mapping">/*<![CDATA[*/window.___chunkMapping={"app":["/app-e66f2aa7bc8c0c86fc56.js"],"component---cache-caches-gatsby-plugin-offline-app-shell-js":["/component---cache-caches-gatsby-plugin-offline-app-shell-js-1b36f307aa24b2531fc1.js"],"component---src-templates-categories-template-categories-template-tsx":["/component---src-templates-categories-template-categories-template-tsx-de60fb07c3c2dbf71e40.js"],"component---src-templates-category-template-category-template-tsx":["/component---src-templates-category-template-category-template-tsx-443eb317600cd58ef328.js"],"component---src-templates-index-template-index-template-tsx":["/component---src-templates-index-template-index-template-tsx-59b5cdee74e4e4aa1796.js"],"component---src-templates-not-found-template-not-found-template-tsx":["/component---src-templates-not-found-template-not-found-template-tsx-beac3abddde61f31ff51.js"],"component---src-templates-page-template-page-template-tsx":["/component---src-templates-page-template-page-template-tsx-7af5f99d1e03ea87e021.js"],"component---src-templates-post-template-post-template-tsx":["/component---src-templates-post-template-post-template-tsx-7ff8cd8ef933565cc25d.js"],"component---src-templates-tag-template-tag-template-tsx":["/component---src-templates-tag-template-tag-template-tsx-52623f9e888048dffa04.js"],"component---src-templates-tags-template-tags-template-tsx":["/component---src-templates-tags-template-tags-template-tsx-e0139adf5e793f667dc9.js"]};/*]]>*/</script><script src="/app-e66f2aa7bc8c0c86fc56.js" async=""></script><script src="/framework-294ac00a73e7f73e5862.js" async=""></script><script src="/webpack-runtime-ac90634151130cc21761.js" async=""></script></body></html>
<p>Here’s a <a href="https://github.com/kalinchernev/kalinchernev.github.io/blob/blog/static/videos/netlify-cms-gatsby.mp4" target="_blank" rel="nofollow noopener noreferrer">video of the process</a> from making a draft which is a pull request, opening a preview and then publishing the change which gets automatically deployed on the site.</p></div></div></div><div class="Post-module--footer--f8705"><div class="Meta-module--meta--dae0a"><p class="Meta-module--date--4d30d">Published<!-- --> <!-- -->Aug 17, 2017</p></div><div class="Tags-module--tags--18589"><ul class="Tags-module--list--82ae6"><li class="Tags-module--item--52015"><a class="Button-module--button--b1113" href="/tag/jamstack/">JAMStack</a></li><li class="Tags-module--item--52015"><a class="Button-module--button--b1113" href="/tag/javascript/">JavaScript</a></li><li class="Tags-module--item--52015"><a class="Button-module--button--b1113" href="/tag/gatsbyjs/">GatsbyJS</a></li></ul></div><div class="Author-module--author--1c58d"><p class="Author-module--bio--08950">Writing crystallizes thought and thought produces action.<a class="Author-module--twitter--90647" href="https://www.twitter.com/kalinchernev" rel="noopener noreferrer" target="_blank"><strong>Kalin Chernev</strong> on Twitter</a></p></div></div><div class="Post-module--comments--d3b99"><div id="disqus_thread"></div></div></div></div></div><div id="gatsby-announcer" style="position:absolute;top:0;width:1px;height:1px;padding:0;overflow:hidden;clip:rect(0, 0, 0, 0);white-space:nowrap;border:0" aria-live="assertive" aria-atomic="true"></div></div><script id="gatsby-script-loader">/*<![CDATA[*/window.pagePath="/admin-ui-gatsby-static-site-generator";window.___webpackCompilationHash="d2e30af708db511272a5";/*]]>*/</script><script id="gatsby-chunk-mapping">/*<![CDATA[*/window.___chunkMapping={"app":["/app-d3c32cc004471fd4eec8.js"],"component---cache-caches-gatsby-plugin-offline-app-shell-js":["/component---cache-caches-gatsby-plugin-offline-app-shell-js-1b36f307aa24b2531fc1.js"],"component---src-templates-categories-template-categories-template-tsx":["/component---src-templates-categories-template-categories-template-tsx-de60fb07c3c2dbf71e40.js"],"component---src-templates-category-template-category-template-tsx":["/component---src-templates-category-template-category-template-tsx-443eb317600cd58ef328.js"],"component---src-templates-index-template-index-template-tsx":["/component---src-templates-index-template-index-template-tsx-59b5cdee74e4e4aa1796.js"],"component---src-templates-not-found-template-not-found-template-tsx":["/component---src-templates-not-found-template-not-found-template-tsx-beac3abddde61f31ff51.js"],"component---src-templates-page-template-page-template-tsx":["/component---src-templates-page-template-page-template-tsx-7af5f99d1e03ea87e021.js"],"component---src-templates-post-template-post-template-tsx":["/component---src-templates-post-template-post-template-tsx-7ff8cd8ef933565cc25d.js"],"component---src-templates-tag-template-tag-template-tsx":["/component---src-templates-tag-template-tag-template-tsx-52623f9e888048dffa04.js"],"component---src-templates-tags-template-tags-template-tsx":["/component---src-templates-tags-template-tags-template-tsx-e0139adf5e793f667dc9.js"]};/*]]>*/</script><script src="/app-d3c32cc004471fd4eec8.js" async=""></script><script src="/framework-294ac00a73e7f73e5862.js" async=""></script><script src="/webpack-runtime-6e7b72d8edfa797fc1e5.js" async=""></script></body></html>
2 changes: 1 addition & 1 deletion agile-documentation-api-driven-project/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -183,4 +183,4 @@ <h3 id="deployment" style="position:relative;"><a href="#deployment" aria-label=
<h3 id="conclusions" style="position:relative;"><a href="#conclusions" aria-label="conclusions permalink" class="anchor before"><svg aria-hidden="true" focusable="false" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Conclusions</h3>
<p>Writing this article and sharing some code around it, I’m integrating tools that solve problems which have already been under the radar of the <a href="https://medium.com/@apievangelist" target="_blank" rel="nofollow noopener noreferrer">API Evangelist</a> such as <a href="https://apievangelist.com/2015/02/02/we-need-better-api-documentation-and-ui-deployment-options/" target="_blank" rel="nofollow noopener noreferrer">the need of better API documentation and UI deployment</a> which was later followed up by findings about <a href="https://apievangelist.com/2015/06/27/the-responsive-swagger-driven-version-of-slate-api-documentation-i-was-looking-for/" target="_blank" rel="nofollow noopener noreferrer">improved Swagger UI design solution</a>. Few months ago, there was also a <a href="https://apievangelist.com/2016/09/16/learning-from-the-success-of-swagger-ui/" target="_blank" rel="nofollow noopener noreferrer">reflection article about the success of Swagger UI</a>.</p>
<p>I hope that this article has inspired you to consider some new ways to improve your documentation workflows for your API project. I know that the idea of automated documentation generation with swagger tools is not new. Rather, I aim to introduce some new ideas on solving the problems which have been around on topic for a while with the tools available today to improve productivity.</p>
<p>The tools shown in <a href="https://github.com/kalinchernev/agile-open-api-docs" target="_blank" rel="nofollow noopener noreferrer">the repository</a> are free and vendor-neutral and the documentation build can be deployed to any place which serves you best. So, I encourage you to further experiment with the code and adapt it to work best for your specific needs.</p></div></div></div><div class="Post-module--footer--f8705"><div class="Meta-module--meta--dae0a"><p class="Meta-module--date--4d30d">Published<!-- --> <!-- -->Jan 21, 2017</p></div><div class="Tags-module--tags--18589"><ul class="Tags-module--list--82ae6"><li class="Tags-module--item--52015"><a class="Button-module--button--b1113" href="/tag/apis/">APIs</a></li><li class="Tags-module--item--52015"><a class="Button-module--button--b1113" href="/tag/webdev/">WebDev</a></li><li class="Tags-module--item--52015"><a class="Button-module--button--b1113" href="/tag/open-apis/">Open APIs</a></li><li class="Tags-module--item--52015"><a class="Button-module--button--b1113" href="/tag/swagger/">Swagger</a></li><li class="Tags-module--item--52015"><a class="Button-module--button--b1113" href="/tag/nodejs/">nodejs</a></li><li class="Tags-module--item--52015"><a class="Button-module--button--b1113" href="/tag/documentation/">documentation</a></li></ul></div><div class="Author-module--author--1c58d"><p class="Author-module--bio--08950">Writing crystallizes thought and thought produces action.<a class="Author-module--twitter--90647" href="https://www.twitter.com/kalinchernev" rel="noopener noreferrer" target="_blank"><strong>Kalin Chernev</strong> on Twitter</a></p></div></div><div class="Post-module--comments--d3b99"><div id="disqus_thread"></div></div></div></div></div><div id="gatsby-announcer" style="position:absolute;top:0;width:1px;height:1px;padding:0;overflow:hidden;clip:rect(0, 0, 0, 0);white-space:nowrap;border:0" aria-live="assertive" aria-atomic="true"></div></div><script id="gatsby-script-loader">/*<![CDATA[*/window.pagePath="/agile-documentation-api-driven-project";window.___webpackCompilationHash="11630d3d901a5c2c7fa5";/*]]>*/</script><script id="gatsby-chunk-mapping">/*<![CDATA[*/window.___chunkMapping={"app":["/app-e66f2aa7bc8c0c86fc56.js"],"component---cache-caches-gatsby-plugin-offline-app-shell-js":["/component---cache-caches-gatsby-plugin-offline-app-shell-js-1b36f307aa24b2531fc1.js"],"component---src-templates-categories-template-categories-template-tsx":["/component---src-templates-categories-template-categories-template-tsx-de60fb07c3c2dbf71e40.js"],"component---src-templates-category-template-category-template-tsx":["/component---src-templates-category-template-category-template-tsx-443eb317600cd58ef328.js"],"component---src-templates-index-template-index-template-tsx":["/component---src-templates-index-template-index-template-tsx-59b5cdee74e4e4aa1796.js"],"component---src-templates-not-found-template-not-found-template-tsx":["/component---src-templates-not-found-template-not-found-template-tsx-beac3abddde61f31ff51.js"],"component---src-templates-page-template-page-template-tsx":["/component---src-templates-page-template-page-template-tsx-7af5f99d1e03ea87e021.js"],"component---src-templates-post-template-post-template-tsx":["/component---src-templates-post-template-post-template-tsx-7ff8cd8ef933565cc25d.js"],"component---src-templates-tag-template-tag-template-tsx":["/component---src-templates-tag-template-tag-template-tsx-52623f9e888048dffa04.js"],"component---src-templates-tags-template-tags-template-tsx":["/component---src-templates-tags-template-tags-template-tsx-e0139adf5e793f667dc9.js"]};/*]]>*/</script><script src="/app-e66f2aa7bc8c0c86fc56.js" async=""></script><script src="/framework-294ac00a73e7f73e5862.js" async=""></script><script src="/webpack-runtime-ac90634151130cc21761.js" async=""></script></body></html>
<p>The tools shown in <a href="https://github.com/kalinchernev/agile-open-api-docs" target="_blank" rel="nofollow noopener noreferrer">the repository</a> are free and vendor-neutral and the documentation build can be deployed to any place which serves you best. So, I encourage you to further experiment with the code and adapt it to work best for your specific needs.</p></div></div></div><div class="Post-module--footer--f8705"><div class="Meta-module--meta--dae0a"><p class="Meta-module--date--4d30d">Published<!-- --> <!-- -->Jan 21, 2017</p></div><div class="Tags-module--tags--18589"><ul class="Tags-module--list--82ae6"><li class="Tags-module--item--52015"><a class="Button-module--button--b1113" href="/tag/apis/">APIs</a></li><li class="Tags-module--item--52015"><a class="Button-module--button--b1113" href="/tag/webdev/">WebDev</a></li><li class="Tags-module--item--52015"><a class="Button-module--button--b1113" href="/tag/open-apis/">Open APIs</a></li><li class="Tags-module--item--52015"><a class="Button-module--button--b1113" href="/tag/swagger/">Swagger</a></li><li class="Tags-module--item--52015"><a class="Button-module--button--b1113" href="/tag/nodejs/">nodejs</a></li><li class="Tags-module--item--52015"><a class="Button-module--button--b1113" href="/tag/documentation/">documentation</a></li></ul></div><div class="Author-module--author--1c58d"><p class="Author-module--bio--08950">Writing crystallizes thought and thought produces action.<a class="Author-module--twitter--90647" href="https://www.twitter.com/kalinchernev" rel="noopener noreferrer" target="_blank"><strong>Kalin Chernev</strong> on Twitter</a></p></div></div><div class="Post-module--comments--d3b99"><div id="disqus_thread"></div></div></div></div></div><div id="gatsby-announcer" style="position:absolute;top:0;width:1px;height:1px;padding:0;overflow:hidden;clip:rect(0, 0, 0, 0);white-space:nowrap;border:0" aria-live="assertive" aria-atomic="true"></div></div><script id="gatsby-script-loader">/*<![CDATA[*/window.pagePath="/agile-documentation-api-driven-project";window.___webpackCompilationHash="d2e30af708db511272a5";/*]]>*/</script><script id="gatsby-chunk-mapping">/*<![CDATA[*/window.___chunkMapping={"app":["/app-d3c32cc004471fd4eec8.js"],"component---cache-caches-gatsby-plugin-offline-app-shell-js":["/component---cache-caches-gatsby-plugin-offline-app-shell-js-1b36f307aa24b2531fc1.js"],"component---src-templates-categories-template-categories-template-tsx":["/component---src-templates-categories-template-categories-template-tsx-de60fb07c3c2dbf71e40.js"],"component---src-templates-category-template-category-template-tsx":["/component---src-templates-category-template-category-template-tsx-443eb317600cd58ef328.js"],"component---src-templates-index-template-index-template-tsx":["/component---src-templates-index-template-index-template-tsx-59b5cdee74e4e4aa1796.js"],"component---src-templates-not-found-template-not-found-template-tsx":["/component---src-templates-not-found-template-not-found-template-tsx-beac3abddde61f31ff51.js"],"component---src-templates-page-template-page-template-tsx":["/component---src-templates-page-template-page-template-tsx-7af5f99d1e03ea87e021.js"],"component---src-templates-post-template-post-template-tsx":["/component---src-templates-post-template-post-template-tsx-7ff8cd8ef933565cc25d.js"],"component---src-templates-tag-template-tag-template-tsx":["/component---src-templates-tag-template-tag-template-tsx-52623f9e888048dffa04.js"],"component---src-templates-tags-template-tags-template-tsx":["/component---src-templates-tags-template-tags-template-tsx-e0139adf5e793f667dc9.js"]};/*]]>*/</script><script src="/app-d3c32cc004471fd4eec8.js" async=""></script><script src="/framework-294ac00a73e7f73e5862.js" async=""></script><script src="/webpack-runtime-6e7b72d8edfa797fc1e5.js" async=""></script></body></html>
4 changes: 2 additions & 2 deletions app-e66f2aa7bc8c0c86fc56.js → app-d3c32cc004471fd4eec8.js

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Loading

0 comments on commit 7f256b3

Please sign in to comment.