|Special (235): Links | Apple (10): Apple_Developper_Headlines | Apple_Developper_ReferenceLibrary | Apple_Hot_News | Apple_Press_info | Apple_Support_Knowledge_Base_GarageBand | Apple_Support_Knowledge_Base_Mac_OS_X | Apple_Support_Knowledge_Base_iPhoto | Apple_Support_Knowledge_Base_iPod | Apple_Support_Knowledge_Base_iTunes | Mac_Products_Guide_New_Arrivals | Rumors (16): AppleInsider | Apple_x | Chaosmint | CrazyAppleRumorsSite | DifferentDistrict_Rumors | LoopRumors | MacNews_net | MacRumors | MacRumors_p2 | MacScoop | MacosXrumors | Railheaddesign | SpyMac | TheMacMind | TheNorthernSpy | TheUnofficialAppleWeblog | ThinkSecret | iPod (18): Apple_Support_Knowledge_Base_iPod | MacDVD_iPod | Nikkeibp_iPod | iPodBeat | iPodClub | iPodFan | iPodGear | iPodGeneration | iPodHacks | iPodLounge | iPodNN | iPodNoticias | iPod_Fun | iPod_News_de | iPoders | iPodhead | iPoding | pochoirs | Nederlandstalig (11): AppleNieuws_nl | AppleNieuws_be | BluaP | iPhoneclub | iPhoneWereld | InterMactivity | MacFan | MacFan_Forum | MacFreak | MacHouse | MacMinds | MacOSX_nl | MacVandaag | MacWereld | Nieuwslog_Apple | Nieuwslog_iPhone | OneMoreThing | SandS | MacZone | Yooph | Francais (16): Carpo | LeMacEnLigne | Mac4ever | MacADSL | MacBidouille | MacBooster | MacDigit | MacGeneration | MacOS_ws | MacPlus | Mac_Linux | Mac_vnunet | Macmusic_org_FR | Macp2p_net | NyXen | iPodGeneration | Espanol (6): Conexionmac | DiarioX | FaqMac | MacNoticias | NoticiasMac | iPod_Noticias | Portugese (2): Macmagazine_Noticias | Macmagazine_Secrets | Deutsch (11): Apfelgeruechte | Apfeltalk | MacGuardians_de | MacMiniForum | MacMotion_de | MacNews_de | MacTechNews_de | MacWelt | Mac_and_Win_de | iPodFun | iPod_News_de | Danish (3): MacNyt | MacVaerk | MediaMac_dk | Finish (2): MacSanomat | Macmaailma | Swedish (4): MacFeber | MacNytt | MacWorld_se | Se_99mac | Italian (8): AMUG_AV_Italia | BlogMac | Musimac_it | OSXTips | Poc | Spider_mac | Tevac | faqintosh | Greece (2): HelMUG | MacLoaded | Polish (1): Jabluszko | Russian (2): DeepApple | MacOSX_ru | Mactime | MikeOSX | Taiwanese (3): Frostyplace | Maczin | Oikos | Japanese (14): Apple_jp | CubeDeZope | Garageband_jp | Garagers | LifeWithWebObjects | Logicer | MacDVD_iPod | MacFan_net | MacTechLab | Mac_Page_Ne | Nikkeibp_iPod | PowerBooksNews | Sevencolors | iPodClub | Korean (2): Hangul | MUG | News (104): AFP548 | ATPM | AllOSX | AppleAirportWeblog | AppleDefects | AppleLegal | AppleLust | AppleMatters | AppleMenu | Apple_KB | AsTheAppleTurns | Automatorworld | CubeOwner | DailyTunes | DashboardWidgets | Dashboarddev | DifferentDistrict_News | DotMac | EduRSS_Apple | Folkore | Hardmac | InsanelyGreatMac | JoyOfTech | JustOneMoreThing | KeynoteHQ | LockerGnome | LowEndMac | MaCreate | Mac360 | MacCritic | MacDVonline | MacDailyNews | MacDevCenter | MacDigitalAudio | MacEdition | MacFixIt | MacFoo | MacGo | MacHTPC | MacHacks | MacHelp | MacInTouch | MacJams | MacLevel | MacMegaSite | MacMerc | MacMinute | MacMischief | MacNN | MacNet2 | MacNetJournal | MacNewsWorld | MacOSXHints | MacOSXHints_Tiger | MacObserver | MacPolls | MacShrine | MacSlash | MacSofa | MacStudentDev | MacTeens | MacThemes | MacTips | MacVillage | MacWorld_UK | Mac_on_Intel | MacintoshSecurity | Macmusic_org | MacnCell | Macservers | MusiconMac | MyMac | NZMac | NewsTrove | NonStopMac | OReilly | OS9Forever | OSOpinions | OSXFAQ | OSXGuide | OSXHax | OSx86 | PinoyMac | PowerBookCentral | Powerpage | RancheroWeblog | RandomMaccess | Slashdot_Apple | StudioLog | SurfBits | TheAppleCore | TheMacBase | TheMacMind | TheMacOrchard | TheUnofficialAppleWeblog | TidBITS | TigerTracker | World_of_Apple | iCalShare | iCompositions | iOnMac | ifoAppleStore | macCompanion | macTV | xlr8yourmac | news4mac | Macsupport_ca | MacGeekery | Macmini123 | McMACSite | iPhoneAtlas | iwantaniphone | iPhone_Google | |
| Mac News powered by RancheroWeblog |
Resource id #61On Public Bug Trackers
For open source projects it makes sense to have a public bug tracker. It would be hard to do the work without it.
But for commercial software? It’s not a good idea at all.
(I bring this up because I saw someone suggest this idea recently, and it stuck in my head.)
Decisions about what to work on — and when, and by whom — are complicated. From the outside it might look like it’s as simple as picking the next feature request with the most votes, but it’s not that simple.
A company might prioritize a crashing bug over that bug.
Or that feature might need x, y, z and done first, all of which require major work — maybe it needs some surprising amount of design or under-the-hood work, or both, that the requestors understandably don’t know about. Or it needs a bunch of localizations. Or lots of extra testing because the implementation is complex or wide-ranging — or it’s in an area where it could cause regressions.
Or the person who best knows that area of the code is temporarily on another team to help with another company priority. Or that person is going on vacation.
Or there are features nobody has asked for specifically, but that the company thinks would be awesome, and those get priority.
Or there are a half-dozen features that are low-hanging fruit, and for various reasons it’s a good idea to do a bunch of easy things for a while.
Or the feature doesn’t even really fit with the app: companies make that call all the time. (I never added Usenet support to NetNewsWire, despite getting requests for it.)
Or the feature is actually impossible. Or impossible without spending two years and a few million dollars on research and development first.
Or there’s a new OS feature that should be supported. Or an incompatibility with a new OS to fix.
And so on — the list goes on.
But if you have a public bug tracker, you’d likely find that you’re having to explain your decisions all the time. You’d be constantly defending your plans to people who remind you that Feature X has all these votes, so why hasn’t it shipped yet?
I’d argue that most companies aren’t open and accessible enough. Many companies don’t listen to their users very well. Many don’t even write honest and respectful release notes.
But opening up the bug tracker to the public is just a way to get bogged down: it’s a way to make worse decisions, and make them more slowly.
If you have questions, feedback, or suggestions, please let me know.
The gist is pretty simple: I really, really, really do not want anybody’s information. It’s not interesting or useful to me, and managing it is a burden I don’t want. Most importantly: I believe strongly in not just a decentralized web but a web where privacy is respected.
That said, I do have webserver logs (which, frankly, I complete ignore — I don’t even look at the stats, though that could change), and I collect crash logs when the user opts in, because making sure that the app doesn’t crash is job one.
* * *
While the industry is focused on SSL everywhere, we’re not looking at the other half of surveillance tech.
I’ll actually be attending the Xcoders meeting tomorrow— not just the after-hours thing. I’m making an effort. It’s a new year. Why not?
What’s cool is a talk from Sean McNeil on ReactiveSwift. I’ve been personally skeptical about React-style frameworks on Mac and iOS, because experience, and the wisdom of others with experience, tells me that the further you get from Apple’s frameworks the less your app will feel like a native app.
The best advice has always been “Don’t fight the frameworks!”
But still — this is something I should learn about rather than just dismiss it. So I will.
* * *
Despite my skepticism about React for Mac and iOS apps, I have pretty strong feelings about things I think React folks would agree with: minimize state, for instance. Use immutable objects and structs. Don’t share memory across threads (queues). (NetNewsWire’s coding guidelines goes into more detail.)
The web will, eventually, make everyone a crime victim.
NetNewsWire Diary #3: The Crash Reporter
The consensus choice for crash reporters is PLCrashReporter. It’s solid work.
So I went to add it to NetNewsWire, and here’s what happened:
Because of Apple’s new app notarization service, I needed to have PLCrashReporter get built along with the rest of the app — this way I could turn on the required “hardened runtime” setting. (Correct me if I’m wrong about this! Update next day: I am wrong. See postscript.)
But when I tried to build it there were a bunch of deprecation warnings (OSSpinLock, for instance) — and, since I treat all warnings as errors, it wouldn’t build. (I could turn that off, but I won’t.)
So I forked PLCrashReporter with the idea of fixing those errors myself, but then ran into territory I’m not familiar with and not confident about, so I stopped and deleted my fork.
I thought some more about it, and did some research, and I learned that crash logs are still written to disk. This means I could use the crash log catcher I used to use in NetNewsWire 3 and NetNewsWire Lite 4.
The way it works: at launch time it looks for a crash log in the appropriate folder, and if the most recent crash log has not been seen before, then it prompts the user to send it it in. (A window appears with the text of the crash log, a place to add more info, and some buttons — send or don’t-send.)
This isn’t as slick as an in-process crash catcher — but this system worked for me for years. And it means one less dependency, and it means code I fully understand and control.
It’s a few dozen lines of code compared to adding an entire framework. So that’s what I’m doing.
I think this is the first time that I’ve looked back to old NetNewsWire code. I’m rewriting it in Swift, but using the same logic.
Important note: this code will not be part of the Mac App Store build. For that build, for better or worse, I’ll rely on Apple collecting and reporting crash logs. This crash reporter is just for the non-MAS build.
PS The crash catcher that appeared in earlier versions of NetNewsWire itself had a crashing bug (briefly): it would crash if there were no crash logs found! Which was self-healing — because once there was a crash log it wouldn’t crash any more. This remains my favorite bug ever. :)
PPS Shoutout to Uli Kusterer — my code was originally based on his UKCrashReporter.
PPPS The next day… I was wrong about needing to build PLCrashReporter in order to use the hardened runtime. On the Apple dev forums, Quinn writes:
So… I could just add a pre-built PLCrashReporter binary. But I’m going to stick with my thing anyway, again because it means one less dependency, and it means simpler, smaller code that I understand and control.
(The only remaining dependency like this is for Sparkle. I don’t see any reasonable way of removing that.)
I’ve said before that my fondest hope is that all these people go to prison, and that they come to regard Trump’s decision to run for president as the worst thing that ever happened to them.
It’s not schadenfreude — well, it’s not just that — it’s about justice.
It should be known by all, by everyone everywhere, that long-time criminals and fraudsters who feed hate, who betray their nation, will get what they deserve. They’ll get years behind bars and their liberties taken away. They’ll suffer the condemnation of history, and they’ll be known forever as dirt.
It should be known by their supporters — whose support is based on a mutual love of cruelty — that these kinds of people are buffoons who do not have their best interests at heart. The only interest they serve is their own corrupt self-interest. These kinds of people are not worth supporting.
Some are already in prison or heading there. I hope there are many more, and that this goes all the way to the top.
New Xcoders Site
The Xcoders group is for Seattle-area and Vancouver, BC folks who make apps — by writing code, testing, supporting, designing, and so on. They even let marketers like me in there. :)
I’ve been attending since 2005, but only recently started helping out more formally — I’ve been part of the effort to get our communications working a bit better.
We gave our blog its own domain name, xcoders.org — because that’s how you own your own content on the web. We also set it up to automatically cross-post to Twitter, to our existing @xcoders account.
We’ve still got some work to do with design (and maybe a public calendar?), but we’ve got the standard links up there for downloads, videos, Slack signup, and our code of conduct.
If you use an RSS reader, you can follow it there instead of (or in addition to) Micro.blog or Twitter:
As the site says, there are no talks at the next meeting — we’re going straight to the Cyclops in Belltown (which is just a few blocks from the standard meeting place). Be there!
Special note to people who don’t write code: you’re totally welcome! You’re encouraged to come, in fact, to this meeting and every meeting. It’s a great group of people and we’d like to meet you. :)
Almost all the cats and dogs alive during 9/11 are gone now. I hope we remember the comfort they brought. I remember my kitten.
On Using Stock User Interface Elements on the Mac
The genius of the Mac is its consistency. Users brand-new to any well-done Mac app are able to understand how to use it pretty quickly, in part because they see familiar buttons, popup menus, sidebars, toolbars, and so on that they see everywhere.
While it’s tempting to put your own stamp on things — as you kind of need to on iOS — on the Mac you can relax and use what Apple has provided.
Not least because Apple has already done a better job than you will. Apple’s controls support various accessibility features, and they behave the way Mac users expect. Both of those things are very easy to get wrong, and when you do it wrong the app feels wrong, and people notice.
Mac users love the Mac because of the user interface, not despite it. Remember this.
Another thing worth considering: it’s cheaper. Writing your own custom UI — and maintaining it across macOS releases — takes resources. The more you use Apple’s controls, unmodified (or minimally modified), the easier time you’ll have when the Mac gets new features and behavior updates.
I’m not saying you should avoid beauty and delight. You want your app to be gorgeous; you want your app to make its users happy. Totally! I’m saying that you should design within the constraints of building a good Mac app. And that working within those constraints makes it more likely, not less, that you’ll reach that goal.
Cheri Baker, Eight months without Facebook:
So Basic It’s Not Even Funny
Laura K. Curtis writes about book bloggers and lists a whole bunch you might want to subscribe to:
What delighted me especially was this line: “It’s NetNewsWire for Mac and it’s so basic it’s not even funny.”
And I — earnestly — love this, since it describes my design and development aesthetic so perfectly. So basic it’s not even funny. I might even ask her if I can quote her on the NetNewsWire website. (Update: I did ask.)
* * *
I’ve always been a minimalist, but when I was younger I’d temper that — sometimes extremely (remember the releases of Glassboard with a wood grain background) — because I was afraid my intended audience wouldn’t like it. I was afraid I was too extreme.
I don’t know what the difference is now, but I am completely unafraid to be the designer and coder I am. Or, as a bit of advice I got early in my career put it: be the freak you are.
Maybe just because I’m older? Maybe tastes in general have shifted that way a little? Dunno. But I’m sure glad I got here.
So basic it’s not even funny!
* * *
Yes, I’m aware of the modern use of basic to mean something rather judgmental. I plainly don’t give a fig. (And I don’t think Laura meant it that way.)
I’m on the latest Micro Monday podcast with Jean MacDonald! It was so much fun to do.
Entirely coincidentally — Micro.blog has been open to the public for a year now. Congratulations to Manton and Jean on this big milestone!
Crash Catcher for NetNewsWire?
An actual conversation:
Brent Simmons [9:40 PM]
Wise, Super Old Developer [9:42 PM]
Brent Simmons [9:42 PM]
* * *
Well that’s me being a total jerk. It’s also a measure of my confidence (sure, let’s call it that) in my not shipping crashing bugs.
But it’s worth remembering — here in the real world, outside of a developer’s chatroom — that there are plenty of programmers who think they don’t shipping crashing bugs, but do.
And, despite my confidence, the responsible thing is to include some kind of crash catcher.
* * *
I want something lightweight. Ideally it just opens a new message in Mail with the recipient, subject, and body set. (I could write that UI part myself, if needed.)
It has to be open source, since I’m not going to include any mysterious binaries in an open source app.
What should I do? Is PLCrashReporter the best bet? Or…?
NetNewsWire Status Report: the Last 10%
Which means, yes, I’m down to that last 10%. Old engineering wisdom says that the last 10% takes as much time as the first 90%, which means I have another fours year to go, and it will ship in late 2022.
I’m going to try and beat that, though, and ship in the first quarter of 2019. Let me emphasize the try part of that — there’s no guarantee. But I’m resisting all other temptations and buckling down on NetNewsWire.
What remains, of course, is all the stuff I’ve put off. Like syncing, drag-and-drop in the sidebar, search, and so on. (New app icon coming too.)
Note that I did say the alpha milestone is 91% complete. Let me be clear what I mean by alpha: it will be feature complete and won’t have any known defects. The alpha period will be for testing and finding and fixing bugs.
Once it gets to beta, it will be considered a shipping candidate. If possible there will be zero code changes from beta 1 to shipping. At any rate, code changes, at that point, will be made with extreme reluctance and caution.
(Yes, this is a little different from how other people do things. It’s how I do things.)
My hope is that it will get to alpha in February, and that things will move relatively quickly from there and then it will ship in March. Maybe on my birthday? (March 26.)
Again, that’s just a hope. Anything could happen!
Is there an App Store for Saudi Arabia? I don’t personally have any apps on the App Store — but if I did I’d make them unavailable there.
It’s totally a-okay for businesses and individuals to impose our own sanctions. We should, in fact.
Rainier Diary #10: Ballard’s Tokenizer
Rainier is the app, and Ballard is the language. It’s named for the neighborhood where I live in Seattle. (Using Pacific Northwest names is what I do now.)
Another goal: the code should be understandable and tinker-able. The idea is to create a language where the implementation is not mysterious, where it’s accessible to even new programmers who are willing to put in some effort.
So I’m writing in Swift, at the highest level I can, and I’m writing blog posts which explain things.
The language implementation will have four main parts:
Makes sense, no?
Where I’m At
The tokenizer is probably the least interesting part of all of this, and I don’t think I need to write much to explain it.
The gist of it is that it goes through the string by calling
Which should be super-rare, because the tokenizer does not do much in the way of syntax checking. The tokenizer should be able to handle stuff that is entirely incorrect code.
Checking syntax is the job of the parser. The tokenizer just performs that initial pass that gives the parser something besides raw text to work with.
So, next step: write more tests for the tokenizer, fix any bugs, and then move on to the parser.
The parser will be more challenging, for sure. The evaluator, too — especially since it needs to be able to handle debugging, which means being able to pause, view the variables in the stack, resume, etc.
But one thing at a time: the tokenizer comes first.
One Year of The Omni Show
It just popped in my head to check today — and, sure enough, I’ve been doing The Omni Show podcast for just over a year now.
There are a bunch of reasons why I like doing it. The main reason is that it’s fun to show the personalities of the people who work at Omni — and the personality of the company — to the outside world.
It’s also fun as a way for co-workers to get to know each other a little better. We’re showing our personality to ourselves.
I also like it as documentation. This is a special time — our industry is still so young — and so I like it in the same way I liked doing The Record with Chris Parrish. This history will all be lost unless we record it.
And recording this history means not just talking to the usual suspects, the same people you hear every week. It means talking to people who’ve never been on podcasts before, but who all have stories to tell. This is a personal challenge — it takes extra work to prepare for someone different every episode — but it’s so satisfying. I love it.
PS For the curious: last April I wrote, on The Omni Blog, How We Do the Omni Show.
After the firing of Attorney General Jeff Sessions today — not at all unexpected — we’re closer to the break-glass moment where we take to the streets.
It could happen any moment, any day. Could even be minutes from now. Could have happened by the time you read this.
PS The Democrats retaking the House last night was huge. The next two years were going to be perilous and tumultuous either way — but now we have a way better chance of just outcomes.
But we may walk through fire first.
Why I’m Writing These Particular Apps
On the Rainier Slack group, I was asked why I’m writing the app. What are my goals? What’s my exit strategy?
The below is how I replied. It’s unedited Slack-writing, so forgive me for (for one thing) suggesting that at age 65 I might not be writing code anymore. (I very much hope to be.)
Vote for Democrats Everywhere
The president recently called himself a nationalist — and it’s no stretch at all to call him a white nationalist.
From before his campaign, to his remarks after coming down that escalator in Trump Tower, to everything he’s said and done since — including his recent drumming up of fear about refugees planning to seek asylum in the United States — he’s led the effort to ensure that America respects only white power.
This is antithetical to Western democracy, which is built on individual liberty and equal protection, which says that all adult citizens have the right to vote.
If Republicans in Congress had acted as a check on his power, if they had exercised oversight, then I could plausibly suggest voting for the best candidate in each race.
But that didn’t happen. Not even close. It’s been quite the opposite — Republican politicians have aided him at every conscience-shocking turn, and the Republican party has become the party of white nationalism.
I don’t agree with every position of the Democratic Party, and I certainly don’t agree with every position of the candidates available to me. But that’s always true.
What I know, though, is that a Democratic majority in at least one Congressional chamber would finally allow for checks on the president’s power. There would be oversight, at long last.
And we’d have the chance to preserve Western democracy in the United States, and stop this acceleration toward something dark and old and corrupt and dangerous.
Please vote. Please vote for Democrats.
The latest episode of The Omni Show should be of interest to developers — it’s all about building OmniFocus for the Web.
Remember that OmniFocus is a Mac and iOS app written in Objective-C and Swift. The answer for how Omni made it work on the web is the most Omni thing ever. :)
Introduction to Rainier’s Scripting Language
I just posted a tech note for Rainier’s scripting language, Ballard.
Feedback is welcome, of course. Best place is on the Slack group. (You can find my email address near the bottom of this page and then email me to ask for an invitation.)
(Note: other tech notes on the Rainier site are out of date, so I’d skip ’em for now.)
Why Create a Frontier-Inspired Scripting App?
Let me tell you about Frontier.
It still runs (though on its last leg as a 32-bit app), but I’ll talk about in the past tense, because I’m talking about it in its heyday in the ’90s and early 2000s. I was working at UserLand — Dave Winer’s company, which made Frontier — at the time. I was a Frontier enthusiast before I joined the company. It was my dream job.
Frontier began life as a Mac scripting app, before even AppleScript. While it never lost that ability, it turned into a web scripting app around 1995, which is when I first started using it.
In those days — ’90s and early 2000s — Dave Winer invented, collaborated on, popularized, or fleshed-out a number of things we take for granted today: websites created with scripts and templates, weblogs, RSS, RSS readers, podcasting, OPML, and web APIs (XML-RPC).
It was an extraordinary run of creativity. You might just assume that Dave and his team were writing in Perl or Python or similar — but we weren’t. All this work was done in Frontier.
Does the tool matter?
It’s easy to say that the tool doesn’t really matter, that it was all about the people and that particularly fertile time. And it was about that.
But if the tool doesn’t matter, then why do developers care so much about their tools? Tools matter too.
Nothing in my entire career has ever matched Frontier for how it enabled me to make things quickly. Things that are difficult in other environments — persistence, debugging, seeing the results of a script — are so simple in Frontier. It’s just how the app works. It still feels to me like it comes from the future.
The bet I’m making is that there was something special in this design, that this particular tool was capable of unleashing a level of creativity capable of changing the tech world.
What Frontier Was Like
Frontier was a Mac app (yes, there was a Windows port eventually) with an integrated hierarchic database and scripting system.
The key is that it was a Mac app, in the very best sense — it had that old-school Mac philosophy of taking things that were abstruse and difficult and reserved for the priesthood and giving them an easy-to-use GUI. You browse the database and add, edit, and delete values. Everything lives in the database.
Even your scripts live in the database. Open a script in a window, edit it, click Run or Debug, jump to a different script, etc.
Think of the database like a dictionary that could contain dictionaries. We call those tables, but they’re not at all tables in the SQL sense. (Think hash table.) A table can have subtables, and sub-subtables, and so on.
The database holds scripts, outlines, menubars (you can create menus and attach scripts to menu items), styled text, strings, arrays, booleans, numbers of various types, binary data, and more. (Even some things nobody uses anymore, such as QuickDraw rectangles.)
There’s one simple bit of power — it sounds small to say it, but it’s huge: persisting data from a script is as simple as this:
In the code above, there’s a table named
Quit and relaunch the app — it’s still there.
Like dictionaries, tables have no schema. You can put anything you want into any table. And of course scripts have full power to create, edit, and delete tables and not just values (the database is fully scriptable — that’s the point).
Just as you can refer to database values using dot syntax, a script can call another script the exact same way. In fact, you do that all the time, because the standard library is also stored in the database.
If you call
And of course that works with your own scripts too. There are no import statements — you just call, using dot syntax, whatever you want to call.
The debugger has the standard things — step into, continue, etc. — and you can view the stack when you debug. The stack is just more tables! Which you can also edit, while you’re debugging, like any other Frontier tables.
And the debugger works across scripts — you can step into a call to another script and continue debugging. (This is super-common, even.)
Your one-off scripts are typically stored in the
Getting around was super-easy — if you saw
Brilliantly, and I think uniquely, scripts were written in an outliner. Scripts are, after all, tree structures — and using an outliner for code folding and reorganizing has huge advantages. It feels surprisingly natural, too. I know how how weird that must sound to anyone who’s never written code that way. But, really, all other code editors seem sad to me in comparison, like reindeer that can’t fly. The outliner spoiled me.
(Tabs vs. spaces was never an issue, at least!)
In the end
It was just so easy to start something, and then refine it and keep going, and make things that did useful things.
We wrote blogging software and RSS readers and all kinds of early open web things. (It even had a built-in webserver.) It was fun — it was a joy, even.
I think the Mac is missing this app. So my goal with Rainier (which is a mess at the moment) is to do a new, modern Mac app inspired by Frontier. It won’t be compatible with Frontier, and lots of details will be different, but I hope to capture that same lightning, which, I think, we could use right now.
I could be wrong! Worst case is that I’ll just get back the fun that I miss so much. Which is okay. :)
PS Somebody somewhere is thinking that this is like a very weird, not-object-oriented Smalltalk. It is! But that doesn’t make it less awesome.
PPS I’ve left out a ton of details, but I hope I’ve gotten the gist of this across.
PPPS If you’re interested in joining the Slack group and helping me with my thinking, just email me. (You can find my email on this page.)
NetNewsWire Article Age Limits
RSS readers — at least the several where I know how they work — have some limits on how long they keep articles and how long they track read/unread status.
I may not have the details exactly right, but I recall that Google Reader stopped tracking read/unread status for every article older than 30 days. With NewsGator it was two weeks or the most recent 200 articles. Older versions of NetNewsWire had different limits, depending on which version you’re talking about.
There are several good reasons for limits. One is ethical: piling up unread articles forever isn’t fair to people. Your RSS reader should not be a taskmaster or a source of guilt. Articles should age out after a period of time.
Another is that the more data is saved, the slower database lookups tend to get, and the slower the app gets. In the case of a Mac or iOS app, this also means using more disk space and more energy (more battery).
A third is that if an RSS reader sets the expectation that it creates a personal backup of the internet, then the developer will be doing features, bug fixes, and performance optimizations for this forever, to the detriment of the rest of the app and the majority of its users. (I went through this with earlier versions of NetNewsWire.)
Limits are a necessity. The hard part is deciding what the limits should be, and figuring out how to make them understandable to users.
NetNewsWire will sync with various systems (Feedbin and similar), and, for each syncing account, it will just adopt the limits of each system.
But that still leaves one case where the limits need to be worked out: the non-synced On My Mac account. The below is my thinking (after much discussion with other people) on this.
Articles older than n days will be deleted automatically — but it will preserve a minimum of the 10 most recent articles per feed, and it won’t delete starred items.
(Where n is something like 90 days.)
This is slightly more complex than just aging out older articles. It makes sure that feeds that haven’t been updated in a long time still have their most recent 10 articles.
I think this is reasonable because you don’t want to click on a feed and see zero articles just because it hasn’t been updated in six months (or whatever).
But there’s a tricky part here: how do we define the age of an article? Seems like it should be obvious, but it’s not.
Publication Date vs. Arrival Date
Every article has three dates, though two of them may be empty.
Most of the time, arrival date and publication date will be pretty close. Not always, though — not, for instance, when adding a feed. When it reads a feed for the first time, the arrival date is that moment for each item, while the publication date could be anything.
You might think, naturally, that NetNewsWire should use arrival date when deciding whether or not to delete an article. If it arrived more than n days ago, then it should be deleted, because that means the user has had it for more than n days.
But there’s a problem with that: arrival date is never shown in the user interface. It’s not otherwise an interesting piece of information, where publication date is interesting to users.
So if we have a time-based limit that’s triggered by unseen metadata (arrival date) — and there is visible metadata (publication date) of the exact same type and that seems like it’s directly relevant to age — then I think we have to use the visible date, the publication date.
This makes the limit understandable: you can see the dates, after all, that it uses for its calculation.
(Note: when publication date isn’t specified in the feed, then NetNewsWire uses the arrival date as the publication date, since it will usually be pretty close. Luckily, feeds do tend to include publication dates.)
The one drawback to using publication date, though: it could delete an article with a recent arrival date but a long-ago publication date. I think this is okay — I think it’s the best of the available trade-offs.
The Other Tricky Part: Communicating with the User
The app shouldn’t behave mysteriously. How this works should be clearly communicated.
One option is to just to write about it in the Help book. Unfortunately, people don’t read these all that much.
So here’s what I’m thinking:
Since there will be a preference pane where you can add and edit your various sync accounts (much like in Mail), we have a place for settings for the On My Mac account.
In those settings would be something like this:
Though I most definitely like to limit preferences, this is a reasonable thing to want to configure — and having this there makes it much more likely that a user will see it and learn about the limit.
I think that’s the best call, though it’s not set in stone yet.
Reminder: None of This Applies to Syncing
After reading all these words, you might have forgetten that I’m just talking about the limits of the On My Mac account. Different syncing systems have their own limits, and NetNewsWire will adopt those for the synced accounts.
If you go to the repo you can find my email address and find the bug tracker. You can always email me to ask to be added to the Slack group. But — fair warning! — a lot of the discussion is over super-dry stuff like this issue.
The Design of NetNewsWire’s Timeline
I had some principles in mind for the timeline:
The last one of those — super-fast scrolling — is important. (High performance is a principle of the app in general.)
Luckily, I’ve written so many timelines over the years that I know how to make them fast. Even on my five-year-old MacBook Air — where I spend about 20% of my coding time — scrolling in the app is as fast as it could be.
So let’s set that aside.
The first one of these — “it should be appealing” — is also super-important. But, as a principle, it’s too general, and the answer is subjective.
So that leaves me with two things to think about: including graphics to cut down on the wall of text, and making it easily scannable. If I do a good job designing those two things, then hopefully the result is just naturally appealing — on the grounds that something well-designed for scannability and legibility tends to be appealing.
(Before I go any further: if you want to go get the app — it’s free and open source — you can.)
What Scannability Means
A timeline cell should have enough info that you can quickly figure out, when you glance at it, what it’s likely to be about, where it comes from, and how old it is.
It should be large enough to be able to include that much context, but not so large that you find you have to scroll constantly (even though scrolling is fast).
It should include the title — hopefully the entire title — and perhaps some of the text, for further context. It should include the feed name so you know where it comes from.
Each cell should be the same height as other cells, since this also helps scannability. (I tried a variable-height table early in the development process, and found that a regular height was better.)
After trying a bunch of different layouts — my design process often requires me to actually code a thing and try it (for better or worse) — I settled on the following layout:
The title is bold and dark, since it should stand out the most. The first line of body text, when displayed, is lighter in color and is regular text.
In the case of a title-less article, the layout is this:
For title-less articles, the article text weight is in between the title and body text. Not as bold as the title, not as light as article text. This tells you, at a glance, that you’re reading the first line of an article and not an actual title.
The date and feed name are set in smaller type. The date is bold, which sets it apart from the article title/text above it and the feed name below it.
All text is ellipsized when needed, which lets you know when you’re not seeing the whole thing.
I decided against horizontal grid lines in favor of vertical spacing. This means less visual noise in an area of the app that could easily be too noisy. And, well, it’s a news reader, not a spreadsheet, and using spacing instead of gridlines seemed more publication-like.
This all might seem obvious. I hope so! Of course it wasn’t obvious — but I like it if it seems that way.
I knew I wanted graphics too, in part because they brighten up the UI and keep it from being too text-heavy (and thus hard to scan).
But graphics can serve another purpose: they can quickly tell you something about the article, which helps with scannability.
In NetNewsWire Lite 4.0 I added graphics to the timeline, so this wasn’t a new idea for me. For each article, it looked at the HTML text and found the first image, and assumed it was a featured image. It downloaded those images and made thumbnails to show in the timeline.
This looked pretty cool, brightened up the UI, and cut down on wall-of-text. But it had one major drawback: sometimes the results were a bit risible. Because it was making square thumbnails, it had to crop — which meant sometimes you’d get a nose but no eyes.
And sometimes in trying to find the featured image it would just be a social media sharing icon. Or an image of an emoji. Or a blank tracking image. There was no set of rules that was going to make this work correctly all the time.
And then of course there are plenty of feeds that rarely use images at all. This blog, for instance, or Daring Fireball.
In practice I found that those images — while attractive when they worked — didn’t add that much to scannability (except in the case of photo feeds, which are a minority of feeds, surely).
So, for NetNewsWire 5, I decided to go with feed icons. These are like big favicons, basically, and they serve the purpose of providing a super-fast visual indication of which feed an article comes from.
(Finding these is a bit of a chore. There’s a property for this in JSON Feed, but there are plenty of RSS and Atom feeds out there. So, for those, it downloads the HTML for the home page and attempts to find the feed icon by looking at various metadata properties: the apple touch icon, for instance. I’ll write more about the technical side another day.)
Initially I put them on the left side and moved the text to the right. I was thinking of Twitter and chat and similar apps, where the avatar goes on the left.
The problem there, though, was that not every feed has one of these. So I could either leave the left side blank for those feeds, or move the text all the way to the left — but that made it so sometimes the text was indented (when there’s a graphic) and sometimes not, which looked weird.
So I put them on the right — to my surprise, because I never pictured them there — and it works just fine.
The above all works great for the Today, All Unread, and Starred pseudo-feeds. It works great when a folder is selected, or when multiple feeds are selected.
But when you have a single feed selected, it looked weird to have the feed name and the feed icon repeated a whole bunch of times.
So, in that case, the layout removes the feed icon and the feed name. The row height becomes correspondingly shorter.
It does mean the timeline is a bit more wall-of-text in this case — but it’s also a quick reminder that the selection is a single feed. I think it’s fine — though I could imagine revisiting this.
I could also revisit the idea of using thumbnails of images from article text. There are problems to solve with that, of course.
One idea would be to put a larger, non-cropped version of the image below the rest of the cell — as you see in Twitter and various unfurls. This would bring back variable-height cells, but that’s not necessarily the worst thing. (People deal with variable heights just fine in social media apps.)
Another idea for the timeline — one I’m pretty keen on — is to render microblog posts in full in the timeline. (Microblog in the generic sense, not just posts from Micro.blog.) These would have to include clickable links and basic HTML formatting.
The thing is, I don’t want to just use a web view. To make this work well would mean writing a small HTML layout engine that handles the basics (bold, italics, links, blockquotes, images). While this sounds like a fun challenge, it’s also probably not a one-day project. It would take some time. And right now I’ve got enough other things — syncing, especially — to do, so I’ve put off thinking about this until after 5.0 ships.
Another thing put off until after 5.0 ships: an alternate high-density timeline. I’ve heard from a number of people that they really prefer one-line cells with multiple columns: title, date, feed name. For them this is the most scannable UI, and they liked this exact feature in years-ago versions of NetNewsWire. So it’s something to consider — but, again, I’m not thinking about it till after 5.0 ships.
Though I don’t run in Dark Mode normally — even though it’s beautiful — sometimes I switch to it just to look at NetNewsWire. :)
NetNewsWire Diary #2: Switching to OPML
Since the earliest days of NetNewsWire, before 1.0 even shipped, I wanted to make the subscriptions list on disk an OPML file.
It seemed like using the standard format for listing RSS subscriptions would be a good idea. But I was never able to make that happen — until now, with NetNewsWire 5.0d7.
Why It’s a Good Idea
Given that OPML import and export is a must-have feature — which NetNewsWire already has — then storing the subscriptions on disk as OPML means less code, because there’s just one format to support, instead of supporting both OPML and a custom format for just the app.
It means that the OPML reading and writing code will run for every user on every session, which means any bugs in OPML support won’t be able to hide.
It means a user can get their subscriptions list and move it to another system without first having to launch the app and do an export — the OPML file is already there on disk already.
It also means a user could replace their subscriptions list on disk by swapping in a different OPML file, without having to figure out how to do it through the app.
Why I Never Did This Before
The problem, though, is that the standard OPML format for listing RSS feeds doesn’t have slots for additional metadata. I want to store things like Conditional GET information, the hash of the contents from the last fetch, the edited name as well as the feed’s declared name, and so on.
So for all these years I thought, “Well, that’s too bad. I wish I could use OPML, but I can’t.”
Why I Could Do It Now
It occurred to me I could use a “side table” — that is, a separate place to store feed metadata. This would allow me to store whatever additional data I wanted to store in a separate location.
The go-to for this would normally be SQLite, with some kind of table for feed metadata.
But this has another problem: SQLite is structured storage. There’s a schema. But this doesn’t quite suit feed metadata — especially not when you add in syncing. I wanted the ability to store attributes for each feed without knowing, in advance, what all those attributes might be.
Enter Rainier, the inspired-by-UserLand-Frontier app I’m working on. It includes an object database — that is, it includes a hierarchical, schema-less, key-value database. It’s like a dictionary that can contain nested dictionaries.
Which is perfect for what I wanted to do: I could make each feed a table in an ODB database, and then each feed can store arbitrary key-value pairs. (Think of a “table” in an ODB database as really a dictionary.)
So I built this ODB storage — perhaps ironically, it’s built on top of SQLite, but why not? SQLite is amazing — and its first use is in NetNewsWire.
Rainier-the-app isn’t far enough along to actually do anything at all yet. But a key component of it is now part of NetNewsWire. I expect this pattern to get repeated for a few more things, too — including the (not-nearly-finished) scripting language.
NetNewsWire 5.0d7 is up! See the blog for change notes.
Unofficial Seattle Xcoders tonight — at 6:30 pm at the Cyclops in Belltown. I’ll be there!
There might be some other Omni folks there too unofficially celebrating recent releases. :)
All are welcome! You don’t have to be a coder. Find us in back, on the restaurant side.
I’m 50. I vote every single time, no matter what. Midterms. Primaries. Caucuses. I even vote in that weird non-binding primary that Washington State has.
The latest episode of The Omni Show is ostensibly about launch day — but mostly it’s a discussion of the new design in OmniFocus 3 for Mac. How it started, how it evolved, how it ended up.
It’s of obvious interest to OmniFocus users, but I think the discussion is also interesting to anybody who cares about app design.
(I think it’s one of the best episodes, by far.)
There are just 15 seats left for Swift by Northwest. I’ll be there!
It’s in Portland this October, and it’s going to be fun and educational and you will make new friends. :)
My friend Geoffrey — the one with the big beard in the pictures in the linked-to page — is opening Fair Isle Brewing in Seattle, in Ballard (my neighborhood), next year. They’re doing farmhouse and wild beer.
You can invest as little as $100 if this interests you. More about farmhouse beer:
I think it’s going to be a success — but that’s because I know Geoffrey. We’re talking about investing money here, so please make up your own mind!