{"id":851,"date":"2023-02-24T10:15:36","date_gmt":"2023-02-24T15:15:36","guid":{"rendered":"https:\/\/mfna.org\/rfo\/?p=851"},"modified":"2023-02-24T10:15:36","modified_gmt":"2023-02-24T15:15:36","slug":"should-i-write-a-book","status":"publish","type":"post","link":"https:\/\/mfna.org\/rfo\/2023\/02\/24\/should-i-write-a-book\/","title":{"rendered":"Should I Write A Book?"},"content":{"rendered":"<p>As evidenced by this ongoing blog, I enjoy writing.\u00a0 I have never approached this effort with an audience in mind, and most of my articles are mostly journaling personal opinions and experiences.\u00a0 That said, my current motivation to write more frequently comes from two separate perspectives.\u00a0 The first is my as-yet unannounced retirement, which I hope to make official a little over a month from now.\u00a0 The second is from reading a book that is both informative but frustrating at the same time.\u00a0 It&#8217;s this book that forms the subject of this post.<\/p>\n<p>Here&#8217;s the back story:\u00a0 I try to take a 30-40 minute walk every day.\u00a0 As I&#8217;m heading out the door, I engage the &#8220;Outdoor Walk&#8221; workout on my Apple Watch.\u00a0 I then open the <a href=\"https:\/\/www.mypacer.com\/\" target=\"_blank\" rel=\"noopener\">Pacer<\/a> app on my iPhone, which I use for its audible messages for time and distance.\u00a0 I wondered to myself if I couldn&#8217;t automate that process, which led me to Shortcuts.<\/p>\n<p>Shortcuts is an app that Apple produced and introduced on iOS (iPhone\/iPad) and recently added to the Mac.\u00a0 When it debuted, I took little notice of it, but I quickly realized that AppleScript and Automator (two other, older Apple technologies) were not available outside the Mac, so my attention turned to Shortcuts.<\/p>\n<p>Another back story:\u00a0 As a programmer most of my adult life and throughout my career, I&#8217;ve constantly looked for ways to simplify my computing experience, and have developed a number of scripts and processes using the command line, HyperCard, AppleScript and Automator.\u00a0 Each has required a learning curve, and Apple has followed the trend of making programming languages and their syntax complicated and intimidating.\u00a0 Which I find ironic, as the Mac was originally promoted as the computer for &#8220;the rest of us.&#8221;\u00a0 Hmm.<\/p>\n<p>To add insult to injury, Apple keeps breaking AppleScript with updates to macOS, and now I hear that Automator is likely going to be replaced by Shortcuts.<\/p>\n<p>So, maybe it&#8217;s time for me to learn Shortcuts.<\/p>\n<p>Shortcuts began life as a product called &#8220;Workflow,&#8221; which garnered an Apple Design Award in 2015, and was fully acquired by Apple in 2017.\u00a0 It has since grown added features and in 2021 its availability for macOS was announced.\u00a0 It now supports the entire Apple &#8220;ecosphere,&#8221; Mac, iPad, iPhone, Watch.<\/p>\n<p>Even though Shortcuts attempts to be helpful and usable &#8220;out of the box,&#8221; most of the pre-built &#8220;workflows&#8221; (or &#8220;macros&#8221;) available in the product&#8217;s &#8220;gallery&#8221; do not fit my day to day needs.\u00a0 Time to roll up my sleeves and create my own.<\/p>\n<p>Which is where the dark side of technology is introduced.\u00a0 In its inimitable way, Apple has tried to make Shortcuts usable without writing any code.\u00a0 But by so doing, one must learn the &#8220;Shortcuts way&#8221; of doing things.\u00a0 Sadly, there aren&#8217;t tutorials, and the built-in help is pretty much the only source for information.\u00a0 That is, until I came across the book, <a href=\"https:\/\/www.amazon.com\/Take-Control-Shortcuts-Rosemary-Orchard-ebook\/dp\/B0B852H1KQ\" target=\"_blank\" rel=\"noopener\">Take Control of Shortcuts, 2nd Edition<\/a> by Rosemary Orchard (the delightful irony of both Apple and Orchard being associated is not overlooked!).\u00a0 \u00a0I purchased it (Kindle version, the only format available) in large part because it even addresses changes and additions to the current version of macOS, &#8220;Ventura&#8221; (version 13), which I am running on my modern Macs.<\/p>\n<p>Reading the reviews on Amazon, I was prepared for a less-than-ideal reading and learning experience, so I wasn&#8217;t surprised that the author, while knowledgeable about the subject, chose to attempt to address the differences between platforms every time one occurred.\u00a0 And there are many!\u00a0 I found this distracting and hard to follow.\u00a0 There&#8217;s a lot of good information presented in the book, but I find myself losing track as Orchard follows breadcrumbs here and there.<\/p>\n<p>Which brings me back to the topic of this post:\u00a0 Should I Write A Book?\u00a0 I have given this some (but not a lot) of thought.\u00a0 If I were going to write a book about Shortcuts, how would I structure it?\u00a0 Since I am exposed to a lot of technical documentation through the course of my work, my thinking is that I would probably write it according to this rough outline:<\/p>\n<ul>\n<li>Introduction.\u00a0 What is Shortcuts?\u00a0 Where did it come from?\u00a0 Who can use it, and where to find it.<\/li>\n<li>Definition of terms.\u00a0 It helps to have a clear understanding of terms like &#8220;events,&#8221; &#8220;actions,&#8221; &#8220;variables,&#8221; &#8220;triggers&#8221; and so on.<\/li>\n<li>Core capabilities.\u00a0 Items and processes that are available on all platforms.<\/li>\n<li>Mac differences<\/li>\n<li>iPhone\/iPad differences<\/li>\n<li>Apple Watch differences<\/li>\n<\/ul>\n<p>It always helps to have examples and even do-it-yourself templates.\u00a0 Screenshots and clear step-by-step instructions in abundance would go a long way to adding value to the book.<\/p>\n<p>Almost in spite of Orchard&#8217;s book, I have been able to create two Shortcuts &#8220;macros.&#8221;\u00a0 The first addresses the original desire to automate my workout routine.\u00a0 Because it is started on my Watch and transfers control to my iPhone, it doesn&#8217;t always work.\u00a0 I&#8217;m still looking into that.\u00a0 The second, which I even added comments inside, I have running as a &#8220;service&#8221; on my Mac that just uses the Mac&#8217;s &#8220;Quick Look&#8221; capability to display a random photo from a folder I use for desktop pictures.\u00a0 It doesn&#8217;t serve any real useful purpose, but it&#8217;s kind of fun during a quick break to pop up and display a photo I may not have seen in a while.\u00a0 Here&#8217;s a screenshot of the Shortcut &#8220;code.&#8221;<\/p>\n<p><a href=\"https:\/\/mfna.org\/rfo\/wp-content\/uploads\/2023\/02\/Shortcut-ScreenCap.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-large wp-image-852\" src=\"https:\/\/mfna.org\/rfo\/wp-content\/uploads\/2023\/02\/Shortcut-ScreenCap-1024x1018.png\" alt=\"\" width=\"584\" height=\"581\" srcset=\"https:\/\/mfna.org\/rfo\/wp-content\/uploads\/2023\/02\/Shortcut-ScreenCap-1024x1018.png 1024w, https:\/\/mfna.org\/rfo\/wp-content\/uploads\/2023\/02\/Shortcut-ScreenCap-300x298.png 300w, https:\/\/mfna.org\/rfo\/wp-content\/uploads\/2023\/02\/Shortcut-ScreenCap-150x150.png 150w, https:\/\/mfna.org\/rfo\/wp-content\/uploads\/2023\/02\/Shortcut-ScreenCap-768x764.png 768w, https:\/\/mfna.org\/rfo\/wp-content\/uploads\/2023\/02\/Shortcut-ScreenCap-1536x1527.png 1536w, https:\/\/mfna.org\/rfo\/wp-content\/uploads\/2023\/02\/Shortcut-ScreenCap-302x300.png 302w, https:\/\/mfna.org\/rfo\/wp-content\/uploads\/2023\/02\/Shortcut-ScreenCap.png 1714w\" sizes=\"auto, (max-width: 584px) 100vw, 584px\" \/><\/a><\/p>\n<p>Remember that &#8220;learning curve&#8221; I mentioned earlier?\u00a0 Well, I had to find out what a &#8220;Quick Action&#8221; is (in essence, it&#8217;s like a service one can call from the Services menu on.a Mac) and then I had to learn that I needed to &#8220;continue&#8221; if there was no input.\u00a0 And, since I&#8217;m using folders on my Mac that don&#8217;t exist on my phone or iPad, I had to terminate the shortcut if I was trying to run it on one of them, otherwise I&#8217;d get an error.<\/p>\n<p>I may never write this book.\u00a0 But when I finally retire, I should have the time to learn and explore the Shortcuts app on multiple platforms, and maybe put my knowledge into words.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>As evidenced by this ongoing blog, I enjoy writing.\u00a0 I have never approached this effort with an audience in mind, and most of my articles are mostly journaling personal opinions and experiences.\u00a0 That said, my current motivation to write more &hellip; <a href=\"https:\/\/mfna.org\/rfo\/2023\/02\/24\/should-i-write-a-book\/\">Continue reading <span class=\"meta-nav\">&rarr;<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[7,5],"tags":[],"class_list":["post-851","post","type-post","status-publish","format-standard","hentry","category-technology","category-apple"],"_links":{"self":[{"href":"https:\/\/mfna.org\/rfo\/wp-json\/wp\/v2\/posts\/851","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mfna.org\/rfo\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/mfna.org\/rfo\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/mfna.org\/rfo\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/mfna.org\/rfo\/wp-json\/wp\/v2\/comments?post=851"}],"version-history":[{"count":7,"href":"https:\/\/mfna.org\/rfo\/wp-json\/wp\/v2\/posts\/851\/revisions"}],"predecessor-version":[{"id":859,"href":"https:\/\/mfna.org\/rfo\/wp-json\/wp\/v2\/posts\/851\/revisions\/859"}],"wp:attachment":[{"href":"https:\/\/mfna.org\/rfo\/wp-json\/wp\/v2\/media?parent=851"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/mfna.org\/rfo\/wp-json\/wp\/v2\/categories?post=851"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/mfna.org\/rfo\/wp-json\/wp\/v2\/tags?post=851"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}