Monday, September 30, 2019

The Ten Commandments of Code (or Doc) Reviews

I've seen several articles about how painful code reviews can be for developers, but not as many about documentation reviews. That may be because there aren't as many documentation reviews or they don't get held to the same standards. But they are similar many respects, and they can be painful for writers to endure (speaking from personal experience).

The 10 Commandments of Navigating Code Reviews could almost have been written for technical writers and documentation reviews.
The first two commandments are especially relevant:

  • Thou shall not take it personally.
  • Thou shall not marry thy code (or docs, in the case of writers).

Yes, there are some differences between the two kinds of reviews, but not as many as you might think. Most writers should find this article relevant, espeically if you work for a company that has a formal review process.

Sunday, September 29, 2019

Featured Links - September 29, 2019

Links to things that I found interesting but didn't want to do a full post about.

Friday, September 27, 2019

Sharship!

As William Gibson said: "The future is here now. It's just not evenly distributed." There seems to be a lot of it in Texas right now.

Four Reasons To Use Office Online

I came across the article,
Don’t Pay for Microsoft Word! 4 Reasons to Use Office Online Instead, recently and it prompted me to have a look at Office Online. I can't say that I was impressed.

Yes, it's free and offers some collaborative features. That might do for a simple draft of something. But there's so much missing. The first document I tried to open was password protected; the online version of Word wouldn't open it. Not only that, I couldn't get rid of the warning dialog so I had to close the tab.

Many useful features are missing, track changes, for example. No macros; for me that's a biggie. No cross references either.

The online version of Word might do for a quick letter or note, but I can't imagine using it for anything halfway complex. Even Google Docs, despite its many flaws, is better and at least offers add-ins that provide some of the missing features in the base version.

I might have to upgrade my copy of Office 2013 at some point, but I'll stick with the desktop version, thank you very much.

Thursday, September 26, 2019

Pocket Casts Has Been Updated

The other day I noticed that the Pocket Casts app on my phone had some new features; it had been updated in the background without me noticing. As it turns out, the feature update is part of a major revamp of the application.

For one thing, the mobile app (IOS or Android) is now free; it used to be $3.99. The desktop player is now $1.00 a month or $10 per year. If you paid for the desktop player in the past, it will be free.

New features include the ability to select multiple instances of a podcast at once and mark them as played, download them, or archive them. This is handy and a much needed feature if, like me, you subscribe to a lot of podcasts but there are some you listen to only occasionally.

I did have one problem after the upgrade. The app kept stopping on me. After some googling, I found a topic on their support site that described this problem and provided a solution (I had to fiddle with the battery management settings on my phone).

I've been using Pocket Casts now for about three years and it's earned a spot on my phone's home screen. There are many other podcast apps out there, but I can't think of anything that they could offer that would cause me to switch to something else.


Wednesday, September 25, 2019

How Starships Will Return From Orbit

SpaceX CEO Elon Musk has provided some details about how their Starships will return from orbit. I've been wondering about this, given that there will have to be some form of thermal protection on at least the bottom of the vehicle.
To an extent, Starship’s reentry profile is actually quite similar to NASA’s now-retired Space Shuttle, which took approximately 30 minutes to go from its reentry burn to touchdown. Per the above infographic, it looks like Starship will take approximately 20 minutes from orbit to touchdown, owing to a dramatically different approach once it reaches slower speeds. Originally described by Musk in September 2018 and again in recent weeks, Starship will essentially stall itself until its forward velocity is nearly zero, after which the giant spacecraft will fall belly-down towards the Earth, using its wings and fins to maneuver like a skydiver. The Space Shuttle landed on a runway like a (cement-encased) glider.
This unusual approach allows SpaceX to sidestep the need for huge wings, preventing Starship from wasting far more mass on aerodynamic surfaces it will rarely need. The Space Shuttle is famous for its massive, tile-covered delta wing and the leading-edge shielding that partially contributed to the Columbia disaster. However, it’s a little-known fact that the wing’s size and shape were almost entirely attributable to US Air Force demands for cross-range performance, meaning that the military wanted Shuttles to be able to travel 1000+ miles during reentry and flight. This dramatically constrained the Shuttle’s design and was never once used for its intended purpose.
We will probably find out more this weekend when Musk is scheduled to give a more detailed briefing on the Super Heavy/Starship progress. 

R. I. P., Robert Hunter

Robert Hunter, poet and lyricist for many of the Grateful Dead's most well-known songs, died Sunday evening at the age of 78. 
For the Dead, Garcia and Hunter teamed up for many of the band’s most popular compositions, like “Uncle John’s Band,” “Touch of Grey,” “Casey Jones,” “Friend of the Devil, “Truckin’,” “Franklin’s Tower,” “Eyes of the World,” “Sugaree” and “Scarlet Begonias,” among many others. Hunter also worked with Bob Dylan on multiple songs from the late-’80s onward and more recently has collaborated with songwriters like Bruce Hornsby, Steve Kimock, Jim Lauderdale and David Nelson.
Hunter received the Americana Music Association’s Lifetime Achievement Award in 2013, followed by an induction into the Songwriter’s Hall of Fame (with Garcia) in 2015.
The Relix article does not mention what may be Hunter's most beautiful lyric, to the song, Ripple. I cannot imagine a more fitting
legacy than this:
If my words did glow with the gold of sunshine
And my tunes were played on the harp unstrung,
Would you hear my voice come through the music?
Would you hold it near as it were your own?
It's a hand-me-down, the thoughts are broken,
Perhaps they're better left unsung.
I don't know, don't really care
Let there be songs to fill the air.
Ripple in still water,
When there is no pebble tossed,
Nor wind to blow.

Tuesday, September 24, 2019

How the Invention of Spreadsheet Software Unleashed Wall Street on the World

I discovered spreadsheets almost as soon as they were invented. In the early 1980s, I was working at a camera store and had to manually update a spreadsheet of daily sales using an adding machine. When I got a PC, I was able to convert that to Visicalc and could update it in seconds instead of half an hour.

Later, working at a small software company, I learned about the joys of pivot tables in SuperCalc. Pivot tables are cool tools, by the way, and I used them at the TSX to do an analysis of field names across a series of protocol specifications. (The documents contained lists of fields per messsage; I needed a list of messages by field, and pivot tables made it possible to reorganize the data in that format).

Obviously, my applications were trivial compared to the needs of big companies and Wall Street analysts. However, the more complex the application, the more likelihood of errors, either due to faults in the spreadsheet software, mistaken assumptions, or bad or missing data. And those could have real-world consequences, as this long article in Gizmodo points out.
By shifting much of the actual number work onto techno-tools, Wolfe said, financial firms have widened the gap between decision-makers and the real-world impacts their work achieves.
Regarding his colleagues who worked on The Big Short, Wolfe commented, “They really make clear that people at the top of financial institutions did not fully understand how instruments designed and used by people under them worked. They made billion-dollar bets without understanding what they were doing. They knew the upsides, but not the downsides.”
Incidentally, the so-called “junk bond king” may have argued something similar, Deringer said; in a nutshell, Milken hinted at technological determinism, a concept that lives on at big firms today.
“Apparently at one point he said that, actually, if you wanted to identify who were the real culprits for the new, freewheeling, sort of morally boundary-crossing forms of finance that developed in the ‘80s, the people to really look at were the inventors of VisiCalc,” Deringer said.

What Ad Astra Gets Wrong

On Gizmodo, astrophysicist and film critic, Andy Howell, rips into  Ad Astra, the new big budget space epic starring Brad Pitt.  (Lots of spoilers so don't read it if that bothers you.)
As an astrophysicist and a film critic, I’ve been waiting my whole life for a big-budget adventure film that spans the whole solar system. There are some stunning sequences in Ad Astra, and many of the details about astronaut life and space travel are spot-on. But some of the themes and ideas that drive the plot are based on astronomical misconceptions.
Ad Astra touts itself as having help from NASA, so presumably someone somewhere gave them some advice. Still, there are plenty of ways science advising can go wrong— miscommunication, script conflicts, misconceptions, and outright mistakes. In Ad Astra, those mistakes range from wrong ideas about space travel to inaccuracies about basic astronomy.
What bothers me more is the disregard for real science and physics. I will go to see the movie anyway, but I hate having to turn off the intellectual part of my mind when I sit down in the theatre. Why has it been 50 years and nobody has beaten 2001 at getting it right?

Monday, September 23, 2019

Personalized Concert Sound

I don't go to as many concerts as I used to - the last "rock" concert I went to was the Richard Thompson Electric Trio last December. The sound for that one was about as good as live sound gets in a smallish venue, reasonably loud and clean enough that you could hear the lyrics. But I've been to big concerts in the last couple of years (Rush and Arcade Fire), where the sound was a wall of mud.

That's where Peex comes in. Peex is a set of headphones with a microphone attachment that pick up a broadcast of the concert soundboard feed and allow you to mix it yourself with a phone app.  The built in microphone is used to determine your position in the hall and synchronize the soundboard feed with the sound reaching you. You can up the vocals, turn down the drums, or boost the bass to suit your preferences.
In my testing, the power of Peex became immediately apparent once the first lines of “Bennie and the Jets” hit. With my earbuds out, the audio sounded just as I thought it would (even in the sparkling new Chase Center in San Francisco): A mushy wall of noise reverberating in my skull, lyrics comprehensible only because I already knew what they were. But when I popped in my Peex earbuds, the experience was immediately transformed. Even before I started fiddling with the equalizer settings, I found all the instruments were tighter and scrubbed of echo, and, critically, Sir Elton’s voice rang out above them all, accompanied by his crisp strikes of piano keys.
Once you start fiddling with the equalizer settings it’s hard to stop. By “Tiny Dancer,” I had found the experience benefitted even further by pumping up vocals a few notches along with keyboards, while leaving the other instruments dialed back. As John has a whopping three percussionists on stage, comprising half the band, I quickly realized this powerful trio could be safely leveled down a touch.
Obviously this has to be done with the permission of the performer so you won''t find it available at every concert. Currently, you can try it out on Elton John's farewell tour.

This is a genius idea and I hope I get a chance to try it out sometime.

Dazzle Camouflague and Disruptive Patterns

Until a couple of years ago, I always had the mental picture of World War I battleships as sleek and grey, like their WW II counterparts. But that's not the case, at least not in the latter part of the war. They were painted in what's known as dazzle camouflage with the hope that it would make it harder for enemy gunners to get a correct range on them.


The wonderful Pulp Librarian on Twitter has a long thread about dazzle camouflage and how it was used in WWI. Unfortunately for photographers everywhere, the advent of radar made it unnecessary and it wasn't used in WW II or later.

Dazzle camouflague is part of a larger field known as disruptive colouration or disruptive patterns. I've recently seen articles about it being used to confuse facial recognition systems and to fool the AI vision systems used in self-driving vehicles.

Sunday, September 22, 2019

Featured Links - September 22, 2019

Links to things that I found interesting but didn't want to do a full post about.

Saturday, September 21, 2019

Margaret Atwood's The Testaments On the BBC

BBC Radio 4 is serializing Margaret Atwood's The Testaments, the sequel to her hugely successful and influential novel, The Handmaid's Tale. So far, five episodes are available with two episodes being broadcast each weekday until October 4.

Each episode is about 15 minutes long and will be available for a month after the broadcast date. BBC Radio 4 is available world-wide on the Internet and is free to listen to.


Friday, September 20, 2019

What It Takes To Weigh a Neutrino

You've probably heard of neutrinos–tiny, almost massless particles that can zip through the entire Earth without striking anything. They're not quite massless though, and that's led physicists to go to incredible lengths to weigh them.

The photo below shows part of the experiment that scientists used recently to nail down the neutrino's mass

An experiment nearly two decades in the making has finally unveiled its measurements of the mass of the universe’s most abundant matter particle: the neutrino.
The neutrino could be the weirdest subatomic particle; though abundant, it requires some of the most sensitive detectors to observe. Scientists have been working for decades to figure out whether neutrinos have mass and if so, what that mass is. The Karlsruhe Tritium Neutrino (KATRIN) experiment in Germany has now revealed its first result constraining the maximum limit of that mass. The work has implications for our understanding of the entire cosmos, since these particles formed shortly after the Big Bang and helped shape the way structure formed in the early universe.
The mass turns out to be no more than 1.1 electron volts. Compare that to an electron, which has a mass of about 500,000 eV.

You can read more about the KATRIN experiment on Wikipedia.

Thursday, September 19, 2019

A Space Elevator We Could Build Now

The idea of a space elevator that could carry payloads into orbit without a rocket has been around for quite a while. But the materials strong and light enough to make it practical don't exist yet.

However, there's now a design for a space elevator that uses materials that exist now and could be built with current technology. What makes it possible is that it would be anchored on the moon and go to geosynchronous orbit.
The researchers’ main result is to show that today’s strongest materials—carbon polymers like Zylon—could comfortably support a cable stretching from the moon to geosynchronous orbit. They go on to suggest that a proof-of-principle device made from a cable about the thickness of a pencil lead could be dangled from the moon at a cost measured in billions of dollars.
That’s clearly ambitious but by no means excessive for modern space missions. “By extending a line, anchored on the moon, to deep within Earth’s gravity well, we can construct a stable, traversable cable allowing free movement from the vicinity of Earth to the Moon’s surface,” say Penoyre and Sandford.
The savings would be huge. “It would reduce the fuel needed to reach the surface of the moon to a third of the current value,” they say.
While this is technically feasible, I question whether it makes economic sense. But it would be a heck of a trip, if a long one (at 1,600 km./hr. it would take almost 10 days). 

Don't Qut Your Day Job

A recent article published on Medium has been causing a bit of a stir in the small section of the Twitterverse that I follow. It's written by Heather Demetrios, a successful novelist. Her first books netted her $375,000 in advances, and she thought that she'd hit the big time and started living the life. But sales weren't that great and her next advances got smaller and smaller. Reality bit, big time.

The article offers some solid advice for writers, some of which is applicable to the more mundane writer types who are sitting in cube farms working from contract to contract.

I'm going to add a link to the response by Elizabeth Bear, who is a successful (and very good) author of science fiction and fantasy. Her latest novel, Ancestral Nights, was published earlier this year to generally favourable reviews. Again, while the article is aimed at novelists, some of her points will be applicable to freelance contractors.
  • Pay off your debts when you can, buy durable goods that last when you need them (rather than the cheapest available) and stick to a budget.
  • Don’t spend ludicrous amounts of money on self-promotion and travel. Build your brand and your network by treating people well, making friends, and providing interesting internet content. By all means go to literary festivals, cons, and so forth if you’re invited or if you want to go for the social opportunities, but if going to cons made you a best seller I would not be sweating how to pay the mortgage now.
  • Be aware that the money is going to come at weird times and it will get held up when totally inconvenient, and sometimes you’re going to have to chase people down who have been sitting on an invoice for months. Sometimes years.
All of this makes me wonder how many writing programs, be they creative writing or technical writing, offer a course on the business aspects of the career?



Wednesday, September 18, 2019

Blocking Calendar Invitation Spam

Spammers, being inventive sorts, have found a way to get spam to you by using calendar invitations. I haven't had any (yet) myself, but from what I've read, it's become a more common problem.

Fortunately, it's easy to block. Follow the instructions in this article from Krebs on Security, which explains what settings you need to change in calendar applications from Google, Microsoft, and Outlook. There may be a downside, however:
Making these changes will mean that any events your email provider previously added to your calendar automatically by scanning your inbox for certain types of messages from common events — such as making hotel, dining, plane or train reservations, or paying recurring bills — may no longer be added for you. Spammy calendar invitations may still show up via email; in the event they do, make sure to mark the missives as spam.

The Training Commission

The Training Commission is a near future science fiction story by Brendan Byrne and Ingrid Burrington, published as a series of emails. You can read it online at the link above.
Several years after a period of civil unrest and digital blackouts in the United States, a truth and reconciliation process has led to a major restructuring of the federal government, major tech companies, and the criminal justice system.
In this still-rebuilding America, freelance journalist Aoife Tkachenko is just trying to make a living (and a name for herself outside of the shadow of her famously-martyred older brother) when she stumbles onto a document from the commission’s archives that many powerful people would rather keep buried. As she digs deeper into the story (all the while dispatching her findings to her newsletter subscribers), Aoife realizes that what she’s found could upend America’s tenuously held peace–and get her killed in the process.
It's quite brilliant featuring excellent characterization and world building coupled with a page turning plot. I am fairly certain that it will be a top contender for next year's Hugo and Nebula awards.

Tuesday, September 17, 2019

Excel Caused Errors in Genetics Research

I have been bitten more than once by Word auto-correcting my text into something I didn't intend. And we have all seen the (sometimes hilarious) results of phone auto-correct run wild. But I didn't know that auto-correct in Excel could be dangerous, until now.

It turns out that many genetics researches have errors in their data because Excel converted common gene names to date format.
The spreadsheet software Microsoft Excel, when used with default settings, is known to convert gene names to dates and floating-point numbers. A programmatic scan of leading genomics journals reveals that approximately one-fifth of papers with supplementary Excel gene lists contain erroneous gene name conversions.
The problem of Excel software (Microsoft Corp., Redmond, WA, USA) inadvertently converting gene symbols to dates and floating-point numbers was originally described in 2004 [1]. For example, gene symbols such as SEPT2 (Septin 2) and MARCH1 [Membrane-Associated Ring Finger (C3HC4) 1, E3 Ubiquitin Protein Ligase] are converted by default to ‘2-Sep’ and ‘1-Mar’, respectively. Furthermore, RIKEN identifiers were described to be automatically converted to floating point numbers (i.e. from accession ‘2310009E13’ to ‘2.31E+13’). Since that report, we have uncovered further instances where gene symbols were converted to dates in supplementary data of recently published papers (e.g. ‘SEPT2’ converted to ‘2006/09/02’). This suggests that gene name errors continue to be a problem in supplementary files accompanying articles. Inadvertent gene symbol conversion is problematic because these supplementary files are an important resource in the genomics community that are frequently reused. Our aim here is to raise awareness of the problem.

A Beginner's Guide to Git

The first project I worked on in my first full-time technical writing job was a manual for IBM's CMVC (Configuration Managment and Version Control). I had no experience at all with the subject and it was a heavy slog. Since then, I have had to use several different version control systems, up to the current favourite, Git.

Free Code Camp has just published a beginner's guide to Git. Since many (if not, most) developers use Git now, some knowledge of how it works is a good thing for technical writers to have. You may even be asked to put your documentation into a Git archive.

This article covers the basics and is a good introduction to version control concepts.

Monday, September 16, 2019

Coup, What Coup?

The ongoing Brexit catastrophe in the United Kingdom has many of the hallmarks of a coup, despite the lack of military intervention. Colin Talbot looks at the current situation and how it mirrors what has gone on in countries that have suffered more foreful authoritarian takeovers.
In other examples of the creeping dethronement of democracy far more extreme tactics have been deployed. Restriction of civil liberties, attacks on civil society organisations, capture of state and independent media organisations, and at its most extreme extra-legal ‘direct action’ have all been employed to further authoritarian rule.
The UK is not there yet – although there are some worrying signs. An MP has been killed and others intimidated out of office. This has a corrosive long-term effect.
The incremental nature of the new authoritarianism is both a strength, and a weakness. It means it is often harder to recognise when boundaries have been crossed and critical changes introduced.
Readers in the US who think that this is not their problem might want to consider a scenario where Trump loses the 2020 election by a slim margin and declares the election illegitimate and refuses to cede the presidency. 

Monitoring the Quality of CSS

CSS (Cascading Style Sheets) has gotten far more complex since it was introduced in the 1990s. I've used it on my web site and in various tools over the years, most recently with WebWorks ePublisher 2018. The latest update to that tool introduced SASS (Syntactically Awesome Style Sheets), which makes large projects much easier to work with but adds an extra layer of abstraction to deal with.

Not being a programmer, I wasn't aware of the existence of linters, tools that check the syntax and quality of programming code (which CSS is certainly now). As it turns out, there are linters for CSS.
We call these mistake-preventing programs "linters." JavaScript has several good ones. ESLint, in particular, has been working wonders, showing us all just how helpful a good linter can be. But in the realm of CSS we have not been so fortunate. We've had very limited options: the Ruby-based, preprocessor-specific scss-lint and the older CSS Lint.
But that was before the advent of PostCSS. Among other things, PostCSS provides the means to build more interoperable CSS tools. It can parse any CSS*-like* syntax into an Abstract Syntax Tree (AST) for plugins to analyze and manipulate. And with custom parsers, PostCSS can handle even non-standard, technically "invalid" patterns (like //-comments).
The conditions are ripe for a mighty new stylesheet linter — powered by PostCSS and inspired by the best features of scss-lint and ESLint.
I've been working with a few collaborators on this project, and I'm writing now to introduce you to the tool we've developed: stylelint.
I wish I'd known about this when I was working on my last WebWorks project. I spent a lot of time trying to figure out why my CSS wasn't doing what I thought it should be doing.

And more powerful CSS tools are being developed.
We’re constantly looking for ways to improve the way we write CSS: OOCSS, BEM, SMACSS, ITCSS, utility-first and more. But where other development communities seem to have progressed from just linters to tools like SonarQube and PHP Mess Detector, the CSS community still lacks tooling for deeper inspection than shallow lint rules. For that reason I have created Project Wallace, a suite of tools for inspecting and enforcing CSS quality.
At the core, Project Wallace is a group of tools that includes a command line interface, linter, analysis, and reporting.
That probably would have been overkill for what I was doing but it would have been interesting to play around with nonetheless. And the web developer who helped me out with one of the projects I worked on certainly would have liked it.

Sunday, September 15, 2019

Saturday, September 14, 2019

We're Toast 12

This post is a collection of links that support my increasingly strong feeling that the human race (or at least our technological civilization) is doomed. It is part of an ongoing series of posts.

Climate Change and Environment

Politics

Technology


Friday, September 13, 2019

Neal Stephenson Interview

I've been reading Neal Stephenson ever since being gobsmacked by his first novel, Snowcrash. It's been an interesting ride. His books are mostly interesting and almost always infuriating, because even after more than 25 years, he still hasn't learned how to end a novel.

He has a new novel, Fall; or, Dodge in Hell, which is sort of a sequel to Reamde, and which I'm probably not going to read (based on reviews by reviewers whose opinions I trust).

More interesting is this long interview with him in Reason magazine.
Is Dickens an influence on you?
Oh yeah. He's totally an influence, as a prose stylist and as someone who's—I mean, we think of Victorian novels as a kind of stodgy old-school way of writing, but he was all over the map in terms of nutty, random things that he would put into his books.
The novels of Robert Heinlein. Are they still readable today, or are they simply of their time?
Well, they're certainly of their time, but I find that, of all of the science fiction writers that I read when I was a kid, his stuff has stayed with me more than others. He had this knack for capturing little moments, little human interactions, and images that produced really vivid memories in my head that are still with me.

Thursday, September 12, 2019

No, You Can't Have My Hyphens

According to the Digital Reader, the Associated Press has revised its guidance about using hyphens in compound modifiers.
We updated our hyphen guidance this year to say no hyphen is needed in a compound modifier if the modifier is commonly recognized as one phrase, and if the meaning is clear and unambiguous without the hyphen.
Personally, that rankles. I'll stick to using hyphens in modifiers for consistency and to avoid the possibility of confusion. 

Biohackers Implant a Hard Drive

I can't resist posting about this story – biohackers have successfully implanted a hard drive into a person's body. They modified parts scavenged from a Raspberry Pi.
Pegleg v2 is built on a Raspberry Pi Zero W, and as portable computers small enough to be inserted under your skin go, it’s relatively large. It’s 2.56 inches long, 1.18 inches wide, and 0.196 inches thick—about the size of a Hershey’s mini chocolate bar. 
To make Pegleg v2, Laufer and his team removed from the Raspberry Pi both Micro USB connectors (one for power, one for data), the Mini HDMI connector, and the camera connector. They then soldered on a second Wi-Fi chip to enable it to transfer data to another Pegleg and allow other devices to connect to it, as well as an induction coil to enable it to be powered by a wireless battery resting in a contiguous sports armband or pants pocket. They enabled Bluetooth for future functionality, inserted a 512GB microSD card for storage, and updated the firmware. Finally, they coated the hacked device in a biocompatible acrylic resin to prevent it from interacting with the recipient’s body and to diffuse the heat it emanates. 
Shades of Johnny Mnemomic, eh? I don't think this will become widespread until drives and networking components become much, much smaller. For a more likely future, see the "smart dust" in Vernor Vinge's A Deepness on the Sky.

Wednesday, September 11, 2019

Kobo Libra H2O Review

Readers outside of Canada may not realize that the Amazon Kindle has a serious competitor, namely Kobo. They've just introduced a new ereader, the Kobo Libra H2O aimed squarely at Amazon's premium Oasis ereader.

Good E-Reader has published a detailed review of the Libra H20, and it looks quite appealing. It features a high-resolution 7" screen, has page turn buttons, and is waterproof.

On the software front, Kobo offers integration with the library ebook download service, Overdrive, which is owned by their parent company, Rakuten, and Pocket for downloading articles from the internet directly to the ereader. Kobo has always offered more typographic controls than Amazon's Kindle and they've added a new feature that I find especially appealing, namely a large-print mode.
There is a large print mode in the beta features, along with an internet browser. Large print mode will change the entire UI and most of the text based features of the software experience and make the fonts larger. This is great for people who wear glasses, have vision disorders or just are getting a little bit older and the eyes aren’t what they used to be. 
That and the 7" screen might be enough for me to consider getting a Kobo Libra H2O.

It will be available starting September 15 in Canada and the US. The Canadian price is $199, which is $60 more than the Kindle Paperwhite, but $130 less than the Kindle Oasis.

Can You Write a Novel as a Group?

As a technical writer, I was used to working in a group of writers. Sometimes there would also be editors and project managers to help us. While writers might have individual documents that were considered theirs, it was always understood that the work was a collaborative effort.

That's very different from the way novelists usually work, alone until the novel is finished, when it goes off to a publisher (assuming the writer has a contract), at which point editors will get involved. Rarely writers will collaborate, but it's not very common. In the science fiction genre, the most successful collaborators are probably James S. A. Corey (Ty Franks and Daniel Abraham) with the Expanse series and Larry Niven and Jerry Pournelle with several best sellers.

But what about writing a novel as a group? Technically, it's now easier than ever with modern software tools. And writers' groups are fairly common now. So why doesn't it happen more?

That's one of the questions raised by this article in the New Yorker.
The pleasures of collaborative fiction writing can seem so bountiful that one might begin to wonder why anybody would choose to do it alone. The varied methods of working as a group—a mixture of talking it out in person (what the Wu Ming collective calls “free-form improv”) and writing in solitude between meetings—give people with different creative temperaments equal chances to contribute. Many of the co-authors said that brainstorming with their collaborators was a safe space in which no idea was too ridiculous and no suggestion would be disregarded. In place of the loneliness and perpetual self-doubt of the solitary writer, they had camaraderie and encouragement from others.
Many of them described being spurred to write better after reading a co-author’s excellent scene. They all felt accountable for doing the work, turning up at meetings, not letting the others down. When the group gets writer’s block, they see it not as evidence of weakness and failure but as a sign that they’re on the wrong path as a group. They cultivate an attitude of “upward compromise,” accepting that they need to do something radical to get the creative juices flowing again—“make it crazier,” or delete everything, or use an “uncanny element, or a plot device that no one else would.”
This all seems perfectly natural to me. I'm not a fiction writer, nor have I ever joined a writers' group, but given my background, it's something that would be more natural to me than most writers.

Tuesday, September 10, 2019

Peck's English Pointers

Some time ago I posted that I had found The Canadian Style online. It's published by the Translation Bureau of  Public Works and Government Services Canada. It looks like my tax dollars are going towards more good things as the Translation Bureau has also published Peck's English Pointers (2nd Edition).
Since 2010 Peck's English Pointers, by Vancouver-based editor and writer Frances Peck, has educated and entertained language buffs with its lively articles and quizzes spanning grammar, punctuation, mechanics, usage and clarity.
The updated second edition features 19 new articles along with 11 new practice quizzes. Like the existing articles, the new ones take a light-hearted yet rigorous look at some of the most perplexing errors, weaknesses and puzzles in written English. The new topics range from mainstream—subject-verb agreement, bullet points, gender-neutral writing and effective emails—to esoteric—subordination, braces, and the little-known comash and interrobang.
With their up-to-date rules, amusing examples and practical advice, these fresh articles join current favourites on who and whom, which and that, hyphens and dashes, plain language, usage woes and grammar myths.
It's divided into five secions covering: Grammar, Punctuation and Mechanics, Usage, Clarity, and Trends and Q&A. In its light tone, it reminds me of the wonderful Dreyer's English. The online interface is somewhat dated, but the content more than makes up for it.


Monday, September 09, 2019

More Controversy About Literary Awards

I posted previously about the controversy surrounding the Campbell award (now Astounding award) for best new SF writer. That's not the only literary award recently to be the source of some controversy.

This article from File 770 reports on the controversy surrounding the Mystery Writers of America's Grand Master award, the James Tiptree award, and the Hugo awards. All of these have had their own little squabbles recently. I hadn't heard about Linda Fairstein and the Mystery Writers of America. It does raise some questions about the separation between art and the artist, even more so perhaps than the Campbell award controversy.
When I heard about Linda Fairstein’s problems with the Mystery Writers of America, I got into an semi-argument with a bookselling friend about what should happen to her. He stated, unequivocally, that her actions in her life should have nothing to do with her work as a writer. 
And, In a fair and a just world, that would happen. But, as we have seen repeatedly over the advent of the internet and social media outlets, there are people out there who would vehemently oppose the most harmless and innocuous you could come up with, including kittens. knitting and lawn bowling. 
I told my friend back then that while it was more than likely that Linda Fairstein probably did deserve the MWA honor, people, her peers, critics, and the public at large and the tidal forces of social interaction she helped foment were going to deny her because of her past actions and her adamant defense of them. 
And then there's what happened with the Nobel award for literature last year,  which will no doubt be in the news again in a few weeks when this year's award is scheduled to be announced.

The History of Unix

Those of you who didn't grow up in the mainframe era of computing may not be aware that Linux, currently the dominant server operating system, is actually a spin off from a much older operating system, Unix. What I didn't know, until I read this article, was that Unix was the offspring of an older and failed operating system called Multics.
Cancellation of Multics meant the end of the only project that the programmers in the Computer science department had to work on—and it also meant the loss of the only computer in the Computer science department. After the GE 645 mainframe was taken apart and hauled off, the computer science department’s resources were reduced to little more than office supplies and a few terminals.
As Ken Thompson, another programmer working on the project, wryly observed for the Unix Oral History project, “Our personal way of life was going to go much more spartan.”
Luckily for computer enthusiasts, constraint can at times lead to immense creativity. And so the most influential operating system ever written was not funded by venture capitalists, and the people who wrote it didn’t become billionaires because of it. Unix came about because Bell Labs hired smart people and gave them the freedom to amuse themselves, trusting that their projects would be useful more often than not. Before Unix, researchers at Bell Labs had already invented the transistor and the laser, as well as any number of innovations in computer graphics, speech synthesis, and speech recognition.
It's hard to imagine what modern computing would be like if Unix hadn't been developed. (Actually, I can imagine it quite well: I worked at IBM for a couple of years.) Sadly, we no longer have Bell Labs; the world might be a better place if we did.

Sunday, September 08, 2019

Featured Links - September 8, 2019

Links to things that I found interesting but didn't want to do a full post about.

Saturday, September 07, 2019

Tips on Using PDFs with Google Drive

Google Drive and Google Docs have some useful features for working with PDF files. I never paid much attention to that when I was working at the TSX because I had the full version of Acrobat. Now that I'm a penniless retiree, I have to scrape by with cheaper alternatives, so it's good to see that Uncle Google is looking after me.

This article lists several ways you can work with PDFs using Google Drive and Google Docs. Note that some of the tips involve using third-party add-ins.

Friday, September 06, 2019

Documenting Software Architecture

For most of my career at the TSX, I reported to the director of architecture. That's an odd placement for a technical writer, but it made sense considering the way the development groups were structured. As well as giving me a good view of the overall development picture, I got to work with software architects on some of their documentation.

Learning about software architecture at a high level will help most technical writers understand how the systems they're documenting work and fit into the larger world. The article, Document Software Architecture, by Herberto Graca, will give you a good overview of what software architecture is and the various ways it can be documented. Based on my own experience, I'd rate it quite highly.


Thursday, September 05, 2019

17 Tips for Google Maps for Android

I use Google Maps a lot. It's especially handy in the car, now that we have a vehicle that supports Android Auto, and we can get real-time traffic information. But it can do a lot more, as this set of 17 tips for Google Maps for Android shows.

Some of these tips are obvious and will likely be known to most users. But some of them are for new features (like augmented reality walking directions) and there are several that I didn't know about at all.

Development of the Energia-Buran Program

The Soviet Union's Buran shuttle only made one flight. It was derided in the West as a copy of the US Space Shuttle, but in reality it was far more than that.


The Twitter thread linked above is a history of the development of the Energia/Buran program with many images and details that I haven't seen before. If you're interested in the history of the Soviet space program, you'll want to read it.

Wednesday, September 04, 2019

Samsung Galaxy Tab A: First Impressions

I've been using an Android tablet for several years, mostly as an ereader. My first tablet was a Galaxy Tab 10.1" and the second an Acer. Both suffered from the same problems: an older version of Android and lack of horsepower. I finally gave up on the Acer, which was running Android 6, when most of the apps I wanted to use became too slow or refused to run outright because Acer wasn't upgrading the OS.

So last week I bought a Samsung Galaxy Tab A (2019) 10.1" tablet from Costco. The price was right, just under $300, and the deciding factor was that it came with Android Pie.

My first impressions are positive. Setup was straightforward. I was able to transfer many of the settings and information like contacts from my Google and Samsung accounts. Given that the tablet only has 2 GB of RAM, I didn't try to load all of the apps from my phone, rather installing only the minimum set that I figured I would use on the tablet. Kudos to Samsung for not installing a bunch of bloatware (Acer, are you listenning?).

The 10.1" screen has a 1980 x 1200 resolution, which given my nearsightedness is perfectly fine. Colours are vivid and there's lots of contrast. The tablet has an octo-core processor and seems adequately fast, although having only 2 GB of RAM might be a problem for some users. Performance is zippy enough, though it's perhaps not as speedy as the Galaxy S4 tablet that I was using at the TSX. There's 32 GB of internal storage and I added a 32 GB micro SD card.  Samsumg rates the tablet for 13 hours of viewing, and that's probably reasonable, as I was able to use it for three or four hours a day for three days before it got down to 30 percent.

The Android 9.0 on the tablet is essentially the same as the Android 9.0 on my Galaxy S8 phone. It's not a specialized tablet OS, like the Android 4.4 and 6.0 on my previous tablets. I'm keeping an eye on updates though, as my phone has been updated to the August 1 security patch, but the tablet is still running the May 1 patch.

My main purpose for buying the tablet is to read magazines from the various library download services, PDF files, and ebooks, and it serves that purpose quite well. (I am planning a blog post about reading magazines online).

So if you're looking for a reasonably priced tablet that's running a current version of Android, the Samsung Galaxy Tab A is definitely worth considering.

And, no, I'm not interested in iPads. They're overpriced and the less connection I have to Apple's ecosytem, the better.

Tuesday, September 03, 2019

Fall TV Shows and Movies Worth Watching

There will be a lot of new TV shows and movies coming out this fall. Rolling Stone has a guide to the best of the upcoming TV shows. Out of the 33 they list, there are a few that I'll probably take a look at:
  • Country Music (PBS, September 15), it's Ken Burns; that's good enough for me.
  • Criminal (Netflix, September 20). With David Tennant. 
  • Evil (CBS, September 26). X-Files meets the Catholic Church.
  • Godfather of Harlem (Epix, September 29). With Forrest Whitaker.
  • Nancy Drew (The CW, October 9). My wife will want to watch this. 
  • The Mandalorian (Disney, November 12). Star Wars live action.
  • The Crown (Netflix, November 12). For all the royals junkies. 
  • Watchmen (HBO, October). I hope it's better than the movie.
  • His Dark Materials (HBO, Fall). Maybe. 
If movies are more your thing, Gizmodo has a guide to 49 (!) horror, sci-fi, and fantasy movies coming out this fall. My standards for watching these are a lot higher than for TV shows given the cost of attending movies these days, but some of these might get my dollars:
  • Memory: The Origins of Alien. Maybe the TIFF Bell Lightbox will screen this.
  • Gemini Man. With Will Smith.
  • Terminator: Dark Fate. He's back. 
  • Star Wars: The Rise of Skywalker. More Star Wars.
  • Cats. I liked the musical a lot. 

Featured Links - September 3, 2019

Links to things that I found interesting but didn't want to do a full post about.