Urgent.News

What's breaking now, across thousands of outlets.

Tech

Most of my content pages are secretly tables. Here is the data shape that works

Every content page I write starts as prose and ends up mostly tables. That was not the plan — it is what happened after watching which parts people actually used. Here is the data shape that kept working, and the three ways tables fail. Why tables win for reference content A reader arriving from a search query has one question. If the answer is "2 to 3 square feet per bird", a paragraph makes…

Every content page the author writes begins as prose before transforming into primarily tables. This was not the initial plan but emerged after observing which parts of the content readers actually engaged with. The author now adheres to a specific data structure that consistently yields successful results, along with understanding common table shortcomings.

When someone uses the site through a search engine, they typically have a single question in mind. If the answer is between 2 to 3 square feet of space per bird, a paragraph would require them to read three sentences to extract the information. However, a table can convey this same data in a single glance. For instance, consider the following two ways of presenting the same information:

"**Hens need roughly two to three square feet of floor space inside the coop, and eight to ten square feet in the run.** Crowding is the single biggest cause of pecking."

vs.

"**Space Per Bird**"

"**Inside the Coop:** 2–3 sq ft"

"In the Run: 8–10 sq ft"

The table format proves more scannable, quotable, and retains its usability even when read on a phone at an inconvenient time, such as 7am in a garden center. The optimal table structure consists of two columns, each representing a single axis of variation. The depth of a raised bed, for example, varies from 15 cm for lettuces, herbs, and radishes, to 30 cm for carrots, peppers, and tomatoes. This depth chart also covers what to do if your bed is already built with the incorrect depth.

One column represents the element that the reader controls, while the other represents the resulting consequence. Adding a third column is only justified if it is genuinely supplementary. For example, a food pantry table listing the storage duration of different grains shows that white rice lasts two years, brown rice lasts 3–6 months, and so on. However, this table has five columns and includes a search box because storage times have a third dimension (sealed vs. unsealed).

Failure Mode 1: Tables that Behave Like Paragraphs

If a table cell contains a sentence with "however" in it, it is no longer tabular data but rather a paragraph in a table costume. This format results in poor readability. To test this, try to read the table by scanning only its first column. If you cannot, the axis may be incorrect.

Failure Mode 2: Tables that Do Not Adapt to Mobile Devices

A 700px wide table on a 390px screen forces the entire page to scroll horizontally, which is an undesirable user experience. The solution is to wrap the table inside a container with the class "table-scroll":

<div class="table-scroll">

<table>

...

</table>

</div>

The .table-scroll CSS rule ensures that the table scrolls horizontally without affecting the rest of the page. Shrink the font instead, as scrolling the entire page is not an ideal solution.

Failure Mode 3: Absence of Caption or Context

A bare table assumes the reader already understands what each column signifies. Adding a one-sentence caption above the table eliminates this assumption. For example:

"Storage times assume an airtight container in a cool, dark place. Heat roughly halves every number here."

This sentence provides essential context for interpreting the table data. Properly marking up the table with <thead> and <th> elements is essential for accessibility. Screen readers will announce the table content as "Space, in the run: 8–10 sq ft," rather than just "8–10 sq ft."

While tables are ideal for lookup, prose is necessary for reasoning. The most useful pages often combine both formats, providing a table for the numbers, a short paragraph explaining the reasoning behind those numbers, and a section discussing exceptions. The companion planting chart is an excellent example, where the chart itself is a table, but the accompanying paragraph explains that most pairings are based on folklore, with only structural effects like shade, support, and trap cropping being reliable.

Written by urgent.news from Dev.to's reporting — not their text. Machine-written — may contain errors; check the original before relying on it.

Read the original at dev.to →

More in Tech

Tides: Tactile After-School Energy Pacing for My 11-Year-Old Daughter

What I Built I built Tides for my 11-year-old daughter, Nia , who just started 6th grade. Entering middle school is an immense sensory, physical, and cognitive leap.

  • App helps 11-year-old manage energy levels after school
  • Tactile zones guide afternoon activities based on energy level
  • Parents monitor progress through Parent Dashboard with key metrics

Steadywag: A Care Agent That Knows What His Paperwork Gets Wrong

This is a submission for the Sanity Challenge, Path One: Ship an Agent That Queries Real Content A medication was on the written list. The dog never got it.

  • Theo, an 8-year-old Shih Tzu, suffers from multiple chronic illnesses.
  • Caregivers relied on care plan documents without noticing a crucial detail.
  • Steadywag app aims to streamline care decisions by consolidating paperwork.

Thoreau BASIC

  • Thoreau BASIC combines classic GW-BASIC syntax with advanced features
  • Supports 64-bit memory, 24-bit graphics, sprites, mouse, and networking
  • Includes JIT compilation, multicore processing, and debugging tools

I built a manga colouriser for a friend, and it runs fully on my laptop

My friend Vinay reads a lot of manga, and it's all black and white. For the Hacktoberfest "Build for a Friend" challenge I built a tool that colours manga pages and keeps each character looking the…

  • Vinay requests manga colorizer for black-and-white pages
  • Application runs locally on laptop without cloud dependencies
  • Uses AI models like Stable Diffusion and OWL-ViT for colorization

TikTok, Reels and Shorts safe zones in pixels

TikTok puts buttons, captions and your name on top of your video. Text under them is hard to read. The safe zone is the area that stays clear.

  • TikTok requires 240px text distance from top, 660px from bottom, 120px from sides
  • Instagram Reels follows TikTok's 269px/672px/65px safe zone measurements
  • YouTube Shorts allows most generous 288px/672px/48px/192px text placement zone

More from Sunday 4 October →