https://batect.dev/assets/js/7ce07cf8.28c8b027.js

1"use strict";(self.webpackChunkbatect_dev=self.webpackChunkbatect_dev||[]).push([[8620],{3905:function(e,t,a){a.d(t,{Zo:function(){return c},kt:function(){return m}});var n=a(7294);function o(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function r(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,n)}return a}function i(e){for(var t=1;t<arguments.length;t++){var a=null!=arguments[t]?arguments[t]:{};t%2?r(Object(a),!0).forEach((function(t){o(e,t,a[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(a)):r(Object(a)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(a,t))}))}return e}function l(e,t){if(null==e)return{};var a,n,o=function(e,t){if(null==e)return{};var a,n,o={},r=Object.keys(e);for(n=0;n<r.length;n++)a=r[n],t.indexOf(a)>=0||(o[a]=e[a]);return o}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(n=0;n<r.length;n++)a=r[n],t.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(o[a]=e[a])}return o}var s=n.createContext({}),h=function(e){var t=n.useContext(s),a=t;return e&&(a="function"==typeof e?e(t):i(i({},t),e)),a},c=function(e){var t=h(e.components);return n.createElement(s.Provider,{value:t},e.children)},u="mdxType",p={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},d=n.forwardRef((function(e,t){var a=e.components,o=e.mdxType,r=e.originalType,s=e.parentName,c=l(e,["components","mdxType","originalType","parentName"]),u=h(a),d=o,m=u["".concat(s,".").concat(d)]||u[d]||p[d]||r;return a?n.createElement(m,i(i({ref:t},c),{},{components:a})):n.createElement(m,i({ref:t},c))}));function m(e,t){var a=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var r=a.length,i=new Array(r);i[0]=d;var l={};for(var s in t)hasOwnProperty.call(t,s)&&(l[s]=t[s]);l.originalType=e,l[u]="string"==typeof e?e:o,i[1]=l;for(var h=2;h<r;h++)i[h]=a[h];return n.createElement.apply(null,i)}return n.createElement.apply(null,a)}d.displayName="MDXCreateElement"},9805:function(e,t,a){var n,o,r=a(7294),i=["title","titleId"];function l(){return l=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var a=arguments[t];for(var n in a)Object.prototype.hasOwnProperty.call(a,n)&&(e[n]=a[n])}return e},l.apply(this,arguments)}function s(e,t){if(null==e)return{};var a,n,o=function(e,t){if(null==e)return{};var a,n,o={},r=Object.keys(e);for(n=0;n<r.length;n++)a=r[n],t.indexOf(a)>=0||(o[a]=e[a]);return o}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(n=0;n<r.length;n++)a=r[n],t.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(o[a]=e[a])}return o}t.Z=function(e){var t=e.title,a=e.titleId,h=s(e,i);return r.createElement("svg",l({xmlns:"http://www.w3.org/2000/svg",width:281.523,height:79,viewBox:"0 0 74.486 20.902","aria-labelledby":a},h),t?r.createElement("title",{id:a},t):null,n||(n=r.createElement("defs",null,r.createElement("path",{id:"a",d:"M34.018 50.649h98.498v50.553H34.018z"}))),o||(o=r.createElement("path",{d:"M4.233 0h3.97v3.969h-3.97zm0 4.233h3.97v3.97h-3.97zm0 4.234h3.97v3.968h-3.97zm0 4.233h3.97v3.969h-3.97zm0 4.233h3.97v3.97h-3.97zm4.234-8.466h3.968v3.968H8.467zm0 8.466h3.968v3.97H8.467zM8.467 0h3.968v3.969H8.467zM12.7 4.233h3.969v3.97H12.7zm0 8.467h3.969v3.969H12.7zm0-4.233h1.852v1.852H12.7zm0 2.116h1.852v1.852H12.7zm0 6.35h1.852v1.852H12.7zm0-14.816h1.852v1.852H12.7zm0-1.059h.794v.794H12.7zm2.117 2.117h.793v.794h-.793zm0 5.292h.793v.793h-.793zm0 3.175h.793v.793h-.793zm0 5.291h.793v.794h-.793zM12.7 19.05h.794v.794H12.7zM0 0h3.969v3.969H0zm0 16.933h3.969v3.97H0z",fill:"#89b400"})),r.createElement("g",{style:{lineHeight:1.25,InkscapeFontSpecification:"'Zilla Slab, Normal'",fontVariantLigatures:"normal",fontVariantCaps:"normal",fontVariantNumeric:"normal",fontVariantEastAsian:"normal",whiteSpace:"pre",shapeInside:"url(#a)"},fontWeight:400,fontSize:32.279,fontFamily:"Zilla Slab"},r.createElement("path",{d:"M52.223 74.148q0 2.485-1.775 4.228-1.776 1.711-5.262 1.711h-9.813v-2.066h2.647v-16.85h-2.647v-2.065h9.652q3.195 0 4.745 1.388 1.582 1.388 1.582 3.647 0 1.679-1.001 2.938-1 1.258-2.615 1.581v.13q2.292.354 3.39 1.872 1.097 1.484 1.097 3.486zm-3.39-9.458q0-1.97-1.129-2.744-1.098-.775-3.067-.775h-4.26v7.102h4.164q1.872 0 3.066-.904 1.227-.936 1.227-2.68zm.872 9.329q0-1.776-1.065-2.776-1.033-1.033-3.099-1.033h-5.164v7.811h4.39q2.26 0 3.583-.936 1.355-.968 1.355-3.066zm6.408-7.199q1.13-.742 2.389-1.065 1.259-.323 2.679-.323 5.132 0 5.132 4.81v6.843q0 1.55 1.227 1.55.549 0 .968-.194l.033 1.485q-.872.484-1.873.484-2.55 0-2.614-2.905v-.065q-.678 1.162-1.937 2.066-1.226.904-2.97.904-1.42 0-2.905-.872-1.452-.871-1.452-3.163 0-2.711 2.13-3.55 2.163-.872 4.584-.872.645 0 1.291.032.678.032 1.259.097V70.79q0-1.55-.678-2.518-.646-.968-2.582-.968-1.582 0-2.776.58l-.55 2.486-1.871-.226zm7.94 7.876V73.6q-.612-.032-1.29-.097-.678-.064-1.388-.064-1.614 0-2.938.516-1.29.484-1.29 2.163 0 1.388.87 1.904.872.517 1.808.517 1.485 0 2.776-1.033 1.324-1.033 1.453-2.809zm16.832 1.518q-.581 4.196-4.551 4.196-2.163 0-3.325-1.227-1.13-1.226-1.13-3.325V67.53h-2.324v-1.807h2.324v-4.616h2.26v4.616h5.616v1.807H74.14v8.038q0 1.291.548 2.098.581.775 1.873.775.839 0 1.549-.517.742-.516 1.065-2.26zm14.205-.259q-.29 1.84-1.84 3.164-1.548 1.29-4.195 1.29-3.035 0-4.907-1.904-1.872-1.904-1.872-5.39 0-3.357 1.775-5.52 1.776-2.163 4.81-2.163 2.97 0 4.519 1.873 1.55 1.872 1.582 4.422 0 .839-.194 1.71H84.665q.193 5.036 4.551 5.036 1.71 0 2.68-.807.968-.807 1.29-2.13zm-2.517-4.196q.161-1.614-.775-3.034-.903-1.42-3.002-1.42-2 0-2.937 1.323-.936 1.323-1.162 3.131zm17.486 3.486q-.29 1.872-1.711 3.519-1.388 1.646-4.358 1.646-2.97 0-4.745-1.905-1.775-1.936-1.775-5.39 0-2.97 1.678-5.326 1.679-2.357 5.036-2.357 1.42 0 2.615.323 1.194.323 2.291 1.162l.55 3.454-1.873.226-.549-2.421q-1.29-.807-3.066-.807-2.292 0-3.293 1.646-1 1.647-1 3.97 0 2.583 1.13 4.036 1.13 1.452 3.26 1.452 3.227 0 3.873-3.647zm12.941.969q-.582 4.196-4.552 4.196-2.163 0-3.325-1.227-1.13-1.226-1.13-3.325V67.53h-2.324v-1.807h2.324v-4.616h2.26v4.616h5.616v1.807h-5.616v8.038q0 1.291.549 2.098.58.775 1.872.775.84 0 1.55-.517.742-.516 1.064-2.26z",style:{InkscapeFontSpecification:"'Zilla Slab, Normal'",fontVariantLigatures:"normal",fontVariantCaps:"normal",fontVariantNumeric:"normal",fontVariantEastAsian:"normal"},"aria-label":"Batect",transform:"translate(1.163 -31.001) scale(.59612)"})))}},4615:function(e,t,a){a.r(t),a.d(t,{assets:function(){return u},contentTitle:function(){return h},default:function(){return f},frontMatter:function(){return s},metadata:function(){return c},toc:function(){return p}});var n=a(7462),o=a(3366),r=(a(7294),a(3905)),i=a(9805),l=["components"],s={title:"New site, new docs, new logo and a capital letter",authors:"charles",tags:["website","docs"]},h=void 0,c={permalink:"/blog/2020/12/06/welcome",editUrl:"https://github.com/batect/batect.dev/blob/main/blog/2020-12-06-welcome.mdx",source:"@site/blog/2020-12-06-welcome.mdx",title:"New site, new docs, new logo and a capital letter",description:"Welcome to the (long-overdue) refreshed batect.dev. This site has been reimagined from the ground up to",date:"2020-12-06T00:00:00.000Z",formattedDate:"December 6, 2020",tags:[{label:"website",permalink:"/blog/tags/website"},{label:"docs",permalink:"/blog/tags/docs"}],readingTime:4.27,hasTruncateMarker:!1,authors:[{name:"Charles Korn",title:"Maintainer",url:"https://github.com/charleskorn",imageURL:"/img/charles.jpg",key:"charles"}],frontMatter:{title:"New site, new docs, new logo and a capital letter",authors:"charles",tags:["website","docs"]}

1,prevItem:{title:"Keep Batect and your configuration up-to-date automatically with Renovate",permalink:"/blog/2020/12/20/renovate-support"}},u={authorsImageUrls:[void 0]},p=[{value:"A logo for Batect (and a capital letter)",id:"a-logo-for-batect-and-a-capital-letter",level:2},{value:"Improved readability",id:"improved-readability",level:2},{value:"Reorganised documentation structure",id:"reorganised-documentation-structure",level:2},{value:"Improved search",id:"improved-search",level:2},{value:"Improved hosting",id:"improved-hosting",level:2},{value:"Elevation of bundles to the top-level navigation",id:"elevation-of-bundles-to-the-top-level-navigation",level:2},{value:"A blog",id:"a-blog",level:2},{value:"A proper home page",id:"a-proper-home-page",level:2},{value:"In closing",id:"in-closing",level:2}],d={toc:p},m="wrapper";function f(e){var t=e.components,a=(0,o.Z)(e,l);return(0,r.kt)(m,(0,n.Z)({},d,a,{components:t,mdxType:"MDXLayout"}),(0,r.kt)("p",null,"Welcome to the (long-overdue) refreshed ",(0,r.kt)("a",{parentName:"p",href:"https://batect.dev"},"batect.dev"),". This site has been reimagined from the ground up to\nbetter serve you. Some of the most exciting changes include:"),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("a",{parentName:"li",href:"#a-logo-for-batect-and-a-capital-letter"},"A logo for Batect (and a capital letter)")),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("a",{parentName:"li",href:"#improved-readability"},"Improved readability")),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("a",{parentName:"li",href:"#reorganised-documentation-structure"},"Reorganised documentation structure")),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("a",{parentName:"li",href:"#improved-search"},"Improved search")),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("a",{parentName:"li",href:"#improved-hosting"},"Improved hosting")),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("a",{parentName:"li",href:"#elevation-of-bundles-to-the-top-level-navigation"},"Elevation of bundles to the top-level navigation")),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("a",{parentName:"li",href:"#a-blog"},"A blog")),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("a",{parentName:"li",href:"#a-proper-home-page"},"A proper home page"))),(0,r.kt)("p",null,"As always, I'm keen to hear your feedback on these changes. Please ",(0,r.kt)("a",{parentName:"p",href:"https://github.com/batect/batect/issues"},"open an issue")," or\n",(0,r.kt)("a",{parentName:"p",href:"https://spectrum.chat/batect"},"post on Spectrum")," if you have any suggestions or encounter any problems."),(0,r.kt)("h2",{id:"a-logo-for-batect-and-a-capital-letter"},"A logo for Batect (and a capital letter)"),(0,r.kt)("p",null,"Batect now has a shiny new logo:"),(0,r.kt)(i.Z,{style:{margin:"1rem auto",display:"block"},mdxType:"Logo"}),(0,r.kt)("p",null,"Much like Batect itself, I've tried to keep it simple. (You'll be pleased to hear I discarded ideas including a dolphin juggling containers\non a unicycle and a rocket with a bunch of containers strapped to the side.)"),(0,r.kt)("p",null,"Oh, and you'll notice that I've embraced the capital letter: the 'official' spelling is now Batect, not batect. The lowercase letter\nalways felt awkward, and others writing about Batect seemed to use the lowercase spelling only around 50% of the time. So, rather than try to fight\nit, I've embraced it. Batect's all grown up now."),(0,r.kt)("p",null,"The new logo and capitalisation should be updated in most places now. If you notice any lowercase instances of 'Batect', please\n",(0,r.kt)("a",{parentName:"p",href:"https://github.com/batect/batect/issues"},"open an issue"),"."),(0,r.kt)("h2",{id:"improved-readability"},"Improved readability"),(0,r.kt)("p",null,"Given that documentation is largely words, getting the display of words right has been a priority for me. This entire site is now built with\n",(0,r.kt)("a",{parentName:"p",href:"https://docusaurus.io/"},"Docusaurus"),", which uses ",(0,r.kt)("a",{parentName:"p",href:"https://facebookincubator.github.io/infima/"}

1,"Infima")," for its default styling. Infima is\ndesigned for content-heavy sites such as documentation, and provides a set of sensible defaults that offer good readability."),(0,r.kt)("p",null,"On top of Infima, I've selected some great open source fonts that help differentiate between body and heading text, making it easier to scan through\nlonger pages."),(0,r.kt)("h2",{id:"reorganised-documentation-structure"},"Reorganised documentation structure"),(0,r.kt)("p",null,"The documentation has been reorganised to better address the needs of different groups of users:"),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},'"I\'m new here, show me what Batect is and why I care": quick ',(0,r.kt)("a",{parentName:"li",href:"/docs/getting-started/hello-world"},"hello world example")," and ",(0,r.kt)("a",{parentName:"li",href:"/docs/getting-started/sample-projects"},"sample projects")),(0,r.kt)("li",{parentName:"ul"},'"Help me get up and running with Batect": deeper ',(0,r.kt)("a",{parentName:"li",href:"/docs/getting-started/tutorial"},"getting started tutorial")," and ",(0,r.kt)("a",{parentName:"li",href:"/docs/getting-started/installation"},"installation instructions"),", as well as conceptual explanations"),(0,r.kt)("li",{parentName:"ul"},'"What\'s the name of the configuration option to do X?": ',(0,r.kt)("a",{parentName:"li",href:"/docs/reference/config"},"configuration file")," and ",(0,r.kt)("a",{parentName:"li",href:"/docs/reference/cli"},"CLI reference"),", as well as a ",(0,r.kt)("a",{parentName:"li",href:"/docs/reference/cheat-sheet"},"cheat sheet")),(0,r.kt)("li",{parentName:"ul"},"\"I'm trying to use Batect with Y, what's the best way to set that up?\": guides for using Batect with different tools and ecosystems"),(0,r.kt)("li",{parentName:"ul"},'"I\'ve got a problem": specific how-to guides for common issues and how to solve them')),(0,r.kt)("p",null,"On top of this reorganisation, each page has been reviewed, updated and clarified, and diagrams have been added in places to aid explanations."),(0,r.kt)("h2",{id:"improved-search"},"Improved search"),(0,r.kt)("p",null,"The old documentation site had very basic search that didn't always find the most relevant results. For example, it struggled with synonyms.\nThe new site uses ",(0,r.kt)("a",{parentName:"p",href:"https://docsearch.algolia.com/"},"Algolia DocSearch")," to provide relevant results, quickly. And it's keyboard friendly as well:\njust press ",(0,r.kt)("kbd",null,"Command"),"+",(0,r.kt)("kbd",null,"K")," (macOS) or ",(0,r.kt)("kbd",null,"Control"),"+",(0,r.kt)("kbd",null,"K")," (Windows and Linux) to open the search dialog."),(0,r.kt)("p",null,(0,r.kt)("em",{parentName:"p"},"(The search index may take 24 hours to pick up the new site - if search seems a bit wacky on December 7 or 8, this will be why.)")),(0,r.kt)("h2",{id:"improved-hosting"},"Improved hosting"),(0,r.kt)("p",null,"The documentation is now hosted on ",(0,r.kt)("a",{parentName:"p",href:"https://www.netlify.com/"},"Netlify"),", which brings a bunch of cool features. The most exciting one is\nsupport for server-side redirects. Previously, I was hesitant to change URLs for fear of breaking links, but this meant that the\ndocumentation wasn't always organised in the most logical way. I'll now be able to more easily shift content around as Batect continues to evolve."),(0,r.kt)("h2",{id:"elevation-of-bundles-to-the-top-level-navigation"},"Elevation of bundles to the top-level navigation"),(0,r.kt)("p",null,"The old bundles page was shoehorned into the old documentation because there wasn't really any other place to put it, but this hid them. They're\nnow highlighted in the top-level navigation at the top of the page, and the layout of the page has been much improved as well."),(0,r.kt)("h2",{id:"a-blog"},"A blog"),(0,r.kt)("p",null,"While documentation is great for more formal communication of information, there wasn't a great way to highlight new features, publish less formal\ntutorials or ideas and make announcements. I'm looking forward to being able to use this blog for all of those things and more."),(0,r.kt)("h2",{id:"a-proper-home-page"},"A proper home page"),(0,r.kt)("p",null,"Batect is no longer just a small project used by a single team - it now has hundreds of users all around the globe. These users (you!) recommend Batect\nto their friends and colleagues, but the old home page that greeted them was a huge wall of text that didn't do a great job of highlighting Batect's\nbest features to those who haven't used it. The new home page is much simpler and gets to the point."),(0,r.kt)("h2",{id:"in-closing"},"In closing"),(0,r.kt)("p",null,"I'm always working to make Batect easier to use and great documentation is a key part of that. If you run into any issues with the new site\nor have any recommendations on how to improve it, please don't hesitate to let me know."))}f.isMDXComponent=!0}}]);