[ Web Proxy ]
URL:
Viewing: https://engineering.squarespace.com/ [Back]  [Original]

Squarespace Engineering Blog

[placeholder]

Search:
Jul 24

Jul 24 Stain the Page: How I Prototype with AI

AI is incredible for rapid idea and hypothesis testing by prototyping. It isn't about writing code its about protecting your most valuable resource: cognitive energy. As engineers, we often face the overwhelming task of determining the look, feel, and architecture of an idea through hundreds of tiny decisions. By the time we get to the novel part of the problem were trying to solve, our brains are tired. We can burn out before we even truly begin.

To solve this, we can steal a trick from artists and writers.

Jun 23

Jun 23 The Importance of Documentation in B2B API Adoption

We read reviews before buying a TV, a sweater, almost anything. Businesses do the same potential enterprise partners evaluate APIs through every piece of content they come across. So, what happens when you improve all of it?

Apr 7

Apr 7 How To Use Standard HTML Video & Audio Lazy-Loading on the Web Today

HTML video and audio lazy loading is now a web standard and quickly gaining support in all major browsers. Given Squarespaces role in proposing and implementing it, were very excited to see how developers use it on the web. Lets cover some best practices for using video and audio lazy loading in any website, as well as some gotchas to avoid.

Mar 30

Mar 30 Squarespace & Web Standards: How We Helped Bring HTML Video & Audio Lazy Loading to Todays Browsers

At Squarespace, many of our core products are built on web standards, and our engineers are constantly pushing the boundaries of the webs capabilities. Occasionally, those boundaries reveal a limitation: an opportunity for the webs native capabilities to grow. This post is the story of how we found such an opportunity to work with the standards community to improve the web in a way that we and everyone who uses it can benefit.

Oct 10

Oct 10 Making Documentation Simpler and Practical: Our Docs-as-Code Journey

In the fast-paced world of software development, documentation often gets a bad rap. It's perceived as a chore, a necessary evil, and sometimes, unfortunately, an afterthought. But what if writing documentation could be as dynamic and collaborative as writing the code itself? What if it could be simpler to write and more practical to use?

May 13

May 13 Leveraging Change Data Capture For Database Migrations At Scale

Our teams love relational databases and the benefits ACID properties bring to us as engineers, but they have their limits, especially in horizontal scaling. We had to adopt new database tech across a fleet of highly available services while eliminating as much risk as possible but how? Enter: change data capture patterning.

Jul 12

Jul 12 Unfold's Modern Mobile Release Process and the Subtle Art of Making Them Boring

On the Unfold team at Squarespace, our mobile releases don't require much in the way of manual intervention or human oversight. In fact, we dont have to give releases much thought at all.

But, this was not always true. This post is a look into what these non-eventful mobile releases are like, dig into how much more eventful they used to be, and walk through the work it took us to get here.

Mar 21

Mar 21 Why We Built a Write Back Cache for Our Asset Library with Google Cloud Spanner

Recently we introduced a write back cache to our Asset Library. This improvement makes life easier for both our customers and our developers. This post walks through the why, the why not and the how.

Dec 6

Dec 6 Outro: What You Did and Whats Next

The outro recaps what you did write technical documentation! and introduces next steps like organizing a collection of documentation, revising existing content, and expanding your technical writing skills by joining the technical writing community.

Dec 5

Dec 5 Part 4: Test, Edit, And Publish Content

After completing Parts 1, 2, and 3 of this tutorial, your once blank page now has technical writing you're officially in the home stretch! Technical writing on a page becomes technical documentation only after you test, edit, and publish the content.

Do not underestimate the exponential payoff that comes from testing and revising content. More than one technical writer can claim that revision has either uncovered bugs in software or improved it.

Nov 28

Nov 28 Part 3: Draft Content Thats Accurate, Consistent, And Concise

In my opinion, creating good headings and organizing them in a way thats helpful to readers is much more challenging than drafting content. So pat yourself on the back for completing Part 2 of this series and making it to Part 3.

However, there are three things that undo exceptional headings and structure in technical documentation: content that is inaccurate, content thats inconsistent, and content thats inflated.

Nov 21

Nov 21 Part 2: Use Good Headings For Structure And Scanning

Part 1 of this tutorial introduced you to the content types that are most common in technical documentation. You also evaluated a real-life example as a reader, and you may have realized how headings are essential to a good reader experience. Its because readers on the web do not read they scan . People actually read 25% slower on the web and they only read 20% of the content on a page. (This data is from 2008; Im scared to know the percentage today.)

Load More

Web Proxy Viewer  |  New URL  |  Original Page