Directory enquiries

I was having a discussion with some of my peers a little while back. We were collectively commenting on the state of education and documentation for front-end development.

A lot of the old stalwarts have fallen by the wayside of late. CSS Tricks hasn’t been the same since it got bought out by Digital Ocean. A List Apart goes through fallow periods. Even the Mozilla Developer Network is looking to squander its trust by adding inaccurate “content” generated by a large language model.

The most obvious solution is to start up a brand new resource for front-end developers. But there are two probems with that:

  1. It’s really, really, really hard work, and
  2. It feels a bit 927.

I actually think there are plenty of good articles and resources on front-end development being published. But they’re not being published in any one specific place. People are publishing them on their own websites.

Ahmed, Josh, Stephanie, Andy, Lea, Rachel, Robin, Michelle …I could go on, but you get the picture.

All this wonderful stuff is distributed across the web. If you have a well-stocked RSS reader, you’re all set. But if you’re new to front-end development, how do you know where to find this stuff? I don’t think you can rely on search, unless you have a taste for slop.

I think the solution lies not with some hand-wavey “AI” algorithm that burns a forest for every query. I think the solution lies with human curation.

I take inspiration from Phil’s fantastic project, ooh.directory. Imagine taking that idea of categorisation and applying it to front-end dev resources.

Whether it’s a post on web.dev, Smashing Magazine, or someone’s personal site, it could be included and categorised appropriately.

Now, there would still be a lot of work involved, especially in listing and categorising the articles that are already out there, but it wouldn’t be nearly as much work as trying to create those articles from scratch.

I don’t know what the categories should be. Does it make sense to have top-level categories for HTML, CSS, and JavaScript, with sub-directories within them? Or does it make more sense to categorise by topics like accessibility, animation, and so on?

And this being the web, there’s no reason why one article couldn’t be tagged to simultaneously live in multiple categories.

There’s plenty of meaty information architecture work to be done. And there’d be no shortage of ongoing work to handle new submissions.

A stretch goal could be the creation of “playlists” of hand-picked articles. “Want to get started with CSS grid layout? Read that article over there, watch this YouTube video, and study this page on MDN.”

What do you think? Does this one-stop shop of hyperlinks sound like it would be useful? Does it sound feasible?

I’m just throwing this out there. I’d love it if someone were to run with it.

Responses

Simon Willison

@adactio I think that format could be tweaked a little - seeing recent additions would be good, and publishing it as a static website (via GitHub Pages), maybe with tags and search - basically a collaborative blog that’s disguised as a directory

Luke Dorny

@adactio egads. With the path that the beautifully informative sites have gone lately, it’s a little disheartening. But with some efforts we could all get it going again. Blogoverse 2.0? Webrings, digests, let the internet bloom again!

# Posted by Luke Dorny on Wednesday, July 10th, 2024 at 4:11pm

Valentin Pratz

@adactio I like the idea of curated resources for a specific topic. Maybe to keep the curation effort low, a curated search engine might be a good starting point as well, similar to @michaellewis ‘s #SearchMySite for the small web? This would require less manual tagging and can stay up to date “automatically” using known-good websites…https://searchmysite.net/

searchmysite Search My Site - Open source search engine and search as a service for personal and independent websites

Jay Hoffmann

@adactio I have often wanted to do something like this for web history resources. I wonder if there is a way to proof of concept this federated technologies and/or a common language of tags to opt-in? I’d be up for working on something like this if there are others interested.

6 Shares

# Shared by David Bushell on Wednesday, July 10th, 2024 at 11:53am

# Shared by Joshua Coleman on Wednesday, July 10th, 2024 at 6:47pm

# Shared by Dave 🧱 :cursor_pointer: on Thursday, July 11th, 2024 at 9:46am

# Shared by Guillaume Deblock on Thursday, July 11th, 2024 at 10:14am

# Shared by Jay Hoffmann on Thursday, July 11th, 2024 at 11:33am

# Shared by iainr on Friday, July 12th, 2024 at 11:17am

5 Likes

# Liked by Adam Perfect on Wednesday, July 10th, 2024 at 11:28am

# Liked by Ana Rodrigues on Wednesday, July 10th, 2024 at 11:28am

# Liked by strongest on Wednesday, July 10th, 2024 at 1:29pm

# Liked by Luke Dorny on Wednesday, July 10th, 2024 at 4:31pm

# Liked by Guillaume Deblock on Thursday, July 11th, 2024 at 10:14am

Related posts

Multi-page web apps

A question via email…

Suspicion

Responses to my thoughts on why developers would trust third-party code more than a native browser feature.

Service workers and videos in Safari

Diagnosing a video playback issue in Safari, thanks to a timely blog post.

Building links

Further reading for the upcoming talk I’m giving at the New Adventures conference.

Posting to my site

The I/O of adactio.com

Related links

Educational Sensational Inspirational Foundational

A historical record of foundational web development blog posts.

Every one of these 42 articles are gold!

It warms my heart to see Resilient Web Design included in this list.

Tagged with

The perfect link - The A11Y Collective

How do we write, design, and code a link that works for everyone on every device? Let’s dive into the world of creating the perfect link, without making a pig’s breakfast of it.

Tagged with

12 Days of Web

All twelve are out, and all twelve are excellent deep dives into exciting web technologies landing in browsers now.

Tagged with

Changing with the times · Chris Burnell

I think, with the sheer volume of functionality available to us nowadays on the front-end, it can be easy to forget how powerful and strong the functionality is that we get right off shelf with HTML. Yes, you read that right, functionality.

Tagged with

What do I need to read to be a great at CSS? – Baldur Bjarnason

I like this approach to reading widely and staying up to date enough.

Tagged with

Previously on this day

6 years ago I wrote Twitter and Instagram progressive web apps

You have nothing to lose but two oversized native apps on your home screen.

6 years ago I wrote Components and concerns

Gotta keep ‘em separated.

7 years ago I wrote Words

When I hear the phrase “I reach for my revolver”, I reach for my red pen.

10 years ago I wrote Chloe

.

17 years ago I wrote Grab your place at dConstruct

Tickets are about to go on sale.

20 years ago I wrote Home again, home again

I’m back from the west of Ireland. I was sorry to leave. I had a wonderful, music-filled time.

21 years ago I wrote I, for one, welcome our new CSS overlords

Everyone’s been talking about the new design over at Adaptive Path. It sure is a beauty; a crisp, clean, elegant design wrapped up in yummy XHTML and CSS.

21 years ago I wrote What decade is your personality living in?

My personality is, apparently, living in the 1990s:

21 years ago I wrote Mirror, mirror

I’ve got a new picture, taken on my trip to Dublin, up at The Mirror Project.