Full Width [alt+shift+f] Shortcuts [alt+shift+k]
Sign Up [alt+shift+s] Log In [alt+shift+l]
52
One of the ways I like to do development is to build something, click around a ton, make tweaks, click around more, more tweaks, more clicks, etc., until I finally consider it done. The clicking around a ton is the important part. If it’s a page transition, that means going back and forth a ton. Click, back button. Click, right-click context menu, “Back”. Click, in-app navigation to go back (if there is one). Click, keyboard shortcut to go back. Over and over and over. You get the idea. It’s kind of a QA tactic in a sense, just click around and try to break stuff. But I like to think of it as being more akin to woodworking. You have a plank of wood and you run it through the belt sander to get all the big, coarse stuff smoothed down. Then you pull out the hand sander, sand a spot, run your hand over it, feel for splinters, sand it some more, over and over until you’re satisfied with the result. With software, the fact is that sometimes there are just too many variables to know and test...
5 months ago

More from Jim Nielsen’s Blog

Notes on Google Search Now Requiring JavaScript

John Gruber has a post about how Google’s search results now require JavaScript[1]. Why? Here’s Google: the change is intended to “better protect” Google Search against malicious activity, such as bots and spam Lol, the irony. Let’s turn to JavaScript for protection, as if the entire ad-based tracking/analytics world born out of JavaScript’s capabilities isn’t precisely what led to a less secure, less private, more exploited web. But whatever, “the web” is Google’s product so they can do what they want with it — right? Here’s John: Old original Google was a company of and for the open web. Post 2010-or-so Google is a company that sees the web as a de facto proprietary platform that it owns and controls. Those who experience the web through Google Chrome and Google Search are on that proprietary not-closed-per-se-but-not-really-open web. Search that requires JavaScript won’t cause the web to die. But it’s a sign of what’s to come (emphasis mine): Requiring JavaScript for Google Search is not about the fact that 99.9 percent of humans surfing the web have JavaScript enabled in their browsers. It’s about taking advantage of that fact to tightly control client access to Google Search results. But the nature of the true open web is that the server sticks to the specs for the HTTP protocol and the HTML content format, and clients are free to interpret that as they see fit. Original, novel, clever ways to do things with website output is what made the web so thrilling, fun, useful, and amazing. This JavaScript mandate is Google’s attempt at asserting that it will only serve search results to exactly the client software that it sees fit to serve. Requiring JavaScript is all about control. The web was founded on the idea of open access for all. But since that’s been completely and utterly abused (see LLM training datasets) we’re gonna lose it. The whole “freemium with ads” model that underpins the web was exploited for profit by AI at an industrial scale and that’s causing the “free and open web” to become the “paid and private web”. Universal access is quickly becoming select access — Google search results included. If you want to go down a rabbit hole of reading more about this, there’s the TechCrunch article John cites, a Hacker News thread, and this post from a company founded on providing search APIs. ⏎ Email :: Mastodon :: Bluesky #generalNotes

4 days ago 9 votes
Missed Connections

Let me tell you about one of the best feelings. You have a problem. You bang your head on it for a while. Through the banging, you formulate a string of keywords describing the problem. You put those words into a search engine. You land on a forum or a blog post and read someone else’s words containing those keywords and more. Their words resonate with you deeply. They’re saying the exact same things you were saying to yourself in your head. You immediately know, “This person gets it!” You know they have an answer to your problem. They’ve seen what you’re seeing. And on top of it all, they provide a solution which fixes your problem! A sense of connection is now formed. You feel validated, understood, seen. They’ve been through what you’re going through, and they wrote about it to reach out to you — across time and space. I fell in love with the web for this reason, this feeling of connection. You could search the world and find someone who saw what you see, felt what you feel, went through what you’re going through. Contrast that with today. Today you have a problem. You bang your head on it. You ask a question in a prompt. And you get back something. But there’s no human behind it. Just a machine which takes human voices and de-personalizes them until the individual point of view is annihilated. And so too with it the sense of connection — the feeling of being validated, understood, seen. Every prompt a connection that could have been. A world of missed connections. Email :: Mastodon :: Bluesky

5 days ago 6 votes
HTML Minification for Static Sites

This is a note to my future self, as I’ve setup HTML minification on a few different projects and each time I ask myself, “How did I do that again?” So here’s your guide, future Jim (and anyone else on the internet who finds this). I use html-minifier to minifiy HTML files created by my static site generator. Personally, I use the CLI tool because it's easy to add a CLI command as an npm postbuild step. Example package.json: { "scripts": { "build": "<BUILD-COMMAND>" "postbuild": "html-minifier --input-dir <BUILD-DIR> --output-dir <BUILD-DIR> --file-ext html <OPTIONS>" } } All the minification options are off by default, so you have to turn them on one-by-one (HTML minfication is a tricky concern). Me personally, I’m using the ones exemplified in the project README: --collapse-whitespace --remove-comments --remove-optional-tags --remove-redundant-attributes --remove-script-type-attributes --remove-tag-whitespace --use-short-doctype --minify-css true --minify-js true So, for a site folder named build, the entire command looks like this: html-minifier --input-dir ./build --output-dir ./build --file-ext html --collapse-whitespace --remove-comments --remove-optional-tags --remove-redundant-attributes --remove-script-type-attributes --remove-tag-whitespace --use-short-doctype --minify-css true --minify-js true That’s it — that’s the template. What Kind of Results Do I Get? I use this on a few of my sites, including my notes site and this blog. When testing it locally for my blog’s build, I: Run a build and put files to ./build Copy ./build to ./build-min Command: cp -R build build-min Run html-minifier on build-min and compare the resulting folders in macOS finder. Here’s my results for my blog (2,501 items in ./build): Directory size: Before: 37MB After: 28.4MB Difference: ▼ -8.6MB (-23.24%) Main index.html file lines of code: Before: 1,484 After: 15 lines Difference: ▼ -1,469 lines (-99%) Main index.html file size over the network: Before: 30.6kB After: 17.6kB Difference: ▼ -13kB (-42.48%) And the results for my notes (one big index.html file): File size: Before: 1.5MB After: 1.1MB Difference: ▼ -0.4MB (-26.67%) Lines of code: Before: 25,974 After: 1 Difference: ▼ -25,973 lines (-99.996%) Email :: Mastodon :: Bluesky #html

6 days ago 14 votes
Consistency For Who? Thoughts on Overriding Basic Computing Controls

A note before we start: I don’t know how much of this I believe. I’m sketching out some feelings in this post and thinking through whether it actually makes any sense. I’d be curious where other folks land on this. I’m not sure I totally understand this impulse we have on the web to override the default style and appearance of fundamental computing controls. Everyone wants their own checkboxes, radios, and select menus that fit their brand. But websites aren’t about you or your brand. They’re about the people you’re serving who have to use them, i.e. the users. And their needs vary from one person to the next, based on their unique context and environment (operating system, device, etc.) For them, a checkbox that’s visually and functionally uniform across every website is a good thing. It provides consistency and sets expectations — “Oh hey, a checkbox, I know how to use this. It looks and functions the same as a checkbox on every other website, app, or system preference on my computer.” But where we’ve arrived on the web is consistency for brands is more important than consistency for end users. Take Radios, For Example Imagine a radio control in macOS. There are some design considerations in how that system-level control looks and functions that are unique to macOS. For example, when a window loses focus in favor of another window, radio controls are de-emphasized visually because the user is now focused on something else in a different window. This is a unique solution for a specific computing experience where multiple windows may be on the screen at the same time and, as the user shifts focus from one window to another, additional visual help is provided to emphasize and de-emphasize the user’s focal point in the user interface. The beauty of leveraging a system-level element is that you’re tapping into these kinds of solutions which are tailored to solve problems unique to their context and environment. Contrast that with a radio somebody re-implemented on the web to match their brand. I highly doubt many have taken into consideration a de-emphasized state for windowed computing experiences. Or Take Select, For Example As another example, consider how the <select> element can break outside of the browser window because it is an OS-level control. For example, have a list with a lot of options? A <select> element can provide users something your custom select never could: an adaptation to its environment, the operating system. If the browser window is small on screen (because, say, the user is trying to do something else within their computing environment like side-by-side windows) the <select> can break out of the browser window and accommodate more space. Similarly, though perhaps not as advantageous, on mobile devices like iOS the <select> can break outside of the browser window. Something a custom element could never do. Additionally, these native controls are incredibly forward looking. If new hardware or OS appears on the scene (see visionOS), how the <select> works is handled for you. When it ships, you’re up to date (vs. a design system where now you have to go consider how, if at all, things change for your entire system and every site it supports). Business case: there’s no more economical way to ship websites than using the platform. You get outside engineering resources to build your UIs at no cost to you! Every component you build is a liability, so what’s the least you can do to deliver value? I get it, there are trade-offs. But when building UIs, how often do we stop to ask: What’s lost when we refuse to consider the context and environment of our users because we instead force upon them the context and environment of our brand? Two Cents on Design Systems We extoll the virtues of a “design system” within our brands and organizations — consistency, familiarity, uniformity, all for our users! But once they leave the walled garden of our brand, it’s ok that they suddenly lose this privilege? If the inconsistencies across design systems for basic computing controls were within our own organizational systems, we would be enraged! But since they’re across brands (e.g. websites), it’s fine? (Below is an example of radios and checkboxes and selects across various popular design systems.) In the end, it’s the user who has to deal with these inconsistencies. But isn’t that what “systems” are meant to solve in the first place? In other words, the default, un-styled, system-level controls for radios, switches, checkboxes, etc., are the original design system before our branded design systems overrode them. Are Organizational Design Systems User-Centric? Your organization’s design system lacks the sensibilities of your users’ platforms. “We made our own radios! They’re great! They’re ‘on-brand’ and consistent across all our stuff.” But they’re not consistent across all your users’ stuff. In other words, you made a radio for your company without considering what makes a radio a radio on the computer it will be used on. You oriented a visual and functional experience around you and your environment, rather than the person you’re serving and their context and environment. And I just tend to think we’re losing out on something with that choice — to say nothing of its cost. Disclaimers Disclaimer 1: I know I’m cheating here. Not all native system controls have been standardized in a way that serves the varied needs of complex applications. But, on the other side of this coin, a simple healthcare form that would be perfectly suited to some basic radio controls and a plain <select> menu instead rolls its UI for no other reason than to make it “on-brand” and it’s worse in almost every way: visually, functionally, accessibly. Disclaimer 2: Yeah I know, this puts us as developers at the mercy of browser vendors and OS platforms and the paltry level of access they give us to system controls. For example, it’s still not easy to mark a checkbox with an indeterminate state in HTML alone. I get that. But perhaps if we spent more time advocating for these kinds of enhancements (instead of re-theming a checkbox for the nth time) maybe we’d get what we ask for? Disclaimer 3: In case it’s not clear, I am not advocating every website everywhere should only use form controls provided by the web platform. The web is a big place, it’s silly to make universal statements for something so big. What I’m trying to do is bring attention to the fact that maybe you don’t need to roll your own. Maybe design systems should consider the computing context and environment of their users over the context and environment of their own brand. Disclaimer 4: I get that system-level consistency is a kind of branded consistency. If you choose an Apple product, you’re choosing an Apple-branded experience for native form controls. I realize these things are not totally brand-agnostic. But consumers make a choice when they buy a computing device, and maybe we should honor that choice rather than try overriding it. Disclaimer 5: Having disclaimers clears me of any and all criticism lol. Email :: Mastodon :: Bluesky

a week ago 82 votes
Relationship Advice for AI

You know what’s really helpful in solving my own problems? Writing them down, sending them to someone, and not hearing back. You ever do that? For me, it’s a bulletproof method to solving problems. It’s akin to those moments when you go to someone with a problem, you talk it through, you find a solution, you thank them for their help, and they say, “Well I didn’t even say anything, but you’re welcome.” If I have a friend, co-worker, or collaborator who I know is on the other end of a chat box, typing out my problem and not hearing back from them can be a tremendous help. Here’s an example of how it often goes: Jim Nielsen, Friday at 12:53 PM I’m having an issue where the deployment isn’t working. Failiures are coming from lines 123-125 of the build script... Jim Nielsen, Friday at 12:59 PM Oh, it looks like something changed in commit abc123e in the lock file... Jim Nielsen, Friday at 1:02 PM This is so weird, I hate troubleshooting this crap. Why is everything in the world garbage? Jim Nielsen, Friday at 1:03 PM Ok, I can’t figure this out. I'm going to need your help when you have a second. Jim Nielsen, Friday at 1:09 PM Oh hey, actually I think I know what the problem is... Jim Nielsen, Friday at 1:11 PM Ok, it’s fixed now. Nevermind, I don’t need your help. Thanks! Co-worker, Friday at 4:03 PM You're welcome, glad I could help! In contrast, AI is too eager to respond back with something when nothing would be much more helpful. Knowing another human is there to connect with — available, listening, but not speaking — has helped me many times as I express my thinking step-by-step. So let me give you some relationship advice, AI. Sometimes you don’t need to say or do anything. You just need to listen. Cool? Thanks. Email :: Mastodon :: Bluesky #ai

a week ago 32 votes

More in literature

'I Can't Quite Recall Your Name'

My first high-school reunion was postponed for a year by the COVID-19 lockdown. We met in 2021 for the fifty-first at a supper club on the Cuyahoga River in Cleveland. Lake Erie was a hundred yards to the north and when conversation lagged, I could watch the ore boats moving down the river. The Cleveland skyline, much of it unrecognizable from childhood, started on the other side of the Cuyahoga. It was a perfect late-summer evening, and we sat on the patio, trying to talk over the “classic rock” blaring from the overhead speakers. I didn’t like the Guess Who in 1970, and that hasn't changed. Nostalgia has become an industry.  I met three of my former teachers, including Linda Wagy, my eight-grade English teacher from 1965-66. It had been her first year teaching and she thoughtfully pretended to remember me. Most of the classmates I had hoped would be there did not attend. The highlight was meeting a woman I knew from thirteen years of public school but hadn’t seen in fifty-one years. I recognized her immediately and even remembered her name. I wrote about our conversation the following day. The dreariest encounter came when I met a guy who has changed his name (his birth name, he explained, had “too many consonants”) and is now a lawyer in Cleveland. He was boring in 1970 and remains so. Boring in a very earnest, strident, self-centered way. It took a long time to shake him so he could bore someone else.   The organizers have announced a fifty-fifth-year reunion to be held in September at the Cleveland Yachting Club, and I plan to go. Mostly I’m curious. In high school I was shy and usually a loner. What friends I had were those I knew from the A.P. classes. My only social involvement was editing the school literary magazine – no dances or sports. There are risks, of course, the principal one being another consonant-free nudnik. The wittily acerbic Louisiana poet Gail White feels otherwise. In “Why I Failed to Attend My High School Reunion,” she says:   “Because it would have gone like this: Hello, hello, hello. (You never liked me, did you? Where was this friendship 15 years ago?) You’re looking wonderful. I wouldn’t kid you about it – you look great. (You hefty cat.) And Jeffrey – are you married? Oh, you are! Three kids? However did you manage that? (For God’s sake, someone point me to the bar.) Me? I’ve just spent the summer in Tibet learning some basics from a Buddhist nun. It’s an experience I won’t forget. (As if you cared.) More crab dip, anyone? (And here’s the Great Class Bore. You’re still the same.) Forgive me. I can’t quite recall your name.”   White explains her poem is “humor based on truth. I’m now 78 and have never been to a class reunion. Nobody who likes me would be there. I didn’t make real friends until I went to college and started meeting people who read books.”

22 hours ago 2 votes
Gary Snyder on How to Unbreak the World

"What we’d hope for on the planet is creativity and sanity, conviviality, the real work of our hands and minds."

yesterday 2 votes
'Intensely and Permanently Interested in Literature'

Another request for a reading list from a young reader. Any reply will be incomplete and risk discouraging aspiring literati. The only infallible inducement to literature is personal pleasure, a notoriously subjective criterion. I love Gibbon and Doughty, and you may find them appallingly tedious. I favor the time-tested and rely on books carrying the seal of approval from generations of readers, and your interests may be strictly contemporary. It’s not dismissive to tell a young reader: jump in anywhere. Like Borges, I assume that one book is potentially all books. That is, gamble a little, select a book that sounds interesting and see where it leads. There’s no shame in closing a book if it disappoints.  In 1909, the English novelist Arnold Bennett published Literary Taste: How to Form It, a sort of self-help guide to English literature. Bennett includes a list of several hundred recommended books, arranged chronologically and giving their prices as of 1909. This is not a snob’s list (though it includes Gibbon and Doughty), and at least a third of the books I have never read. Bennett’s opening sentences:   “At the beginning a misconception must be removed from the path. Many people, if not most, look on literary taste as an elegant accomplishment, by acquiring which they will complete themselves, and make themselves finally fit as members of a correct society. . . . This attitude, or any attitude which resembles it, is wrong. To him who really comprehends what literature is, and what the function of literature is, this attitude is simply ludicrous. It is also fatal to the formation of literary taste.”   Neither Bennett nor I wish to impose a “canon” on anyone. We merely know some of the books that have given us pleasure and perhaps taught us something. We’re small-d democrats. We’re not here to lecture, especially to young readers. Bennett is honest about the potential audience for reading the best books:   "A classic is a work which gives pleasure to the minority which is intensely and permanently interested in literature. It lives on because the minority, eager to renew the sensation of pleasure, is eternally curious and is therefore engaged in an eternal process of rediscovery. A classic does not survive for any ethical reason. It does not survive because it conforms to certain canons, or because neglect would not kill it. It survives because it is a source of pleasure, and because the passionate few can no more neglect it than a bee can neglect a flower. The passionate few do not read ‘the right things’ because they are right.”   So much for fashion.

2 days ago 3 votes
The Epic Viking Saga of the Everyday

Eleanor Barraclough on the ordinary people of Norse history The post The Epic Viking Saga of the Everyday appeared first on The American Scholar.

2 days ago 3 votes
Why Recurring Dream Themes?

...

3 days ago 3 votes