Tags: documentation

Shadow DOM v1: self-contained web components | Web Fundamentals - Google Developers

An in-depth look at the current Shadow DOM spec. It’s well-written but I don’t think this will really click with me until I start playing around with it for myself.

It’s good to see that the examples have some thought given to fallback content.

There’s also a corresponding tutorial on custom elements

Fractal Documentation

This is the tool that we use at Clearleft to generate pattern libraries. It’s pretty damn cool. Mark built it. It’s pretty damn cool.

Qualities of Successful Pattern Libraries: Pick Any Two - Cloud Four

I think Tyler’s onto something here:

I noticed three qualities that recurred in different combinations. Without at least two, the projects seemed doomed to failure.

  1. User-Friendly
  2. Collaborative
  3. Integrated

I certainly think there’s a difference in how you approach a pattern library intended as a deliverable (something we do a lot of at Clearleft) compared to building a pattern library for an ongoing ever-evolving product.

Making And Maintaining Atomic Design Systems With Pattern Lab 2 – Smashing Magazine

A walkthrough of what’s new in Pattern Lab 2. It’s really interesting to see the convergent evolution of ideas here with what’s brewing in Fractal at Clearleft.

FamilySearch Style Guide

A straightforward little pattern library. There’s also the story of making it a living style guide.

Let’s Write Beautiful CSS Comments | Sparkbox

If you don’t comment your CSS, you’ll confuse other people looking at your code, and, more embarrassingly, you’ll confuse future you. If you do comment CSS, everybody will be less confused, and things will be accidentally broken less often. You will be popular and generally well-liked, and people will remember to send you cards on your birthday. Comment more.

Some good advice here on how to write better comments in CSS.

Walmart Web Style Guide

A pattern library of Walmart’s front-end code.

Lightning Design System

A nice combination of style guide and pattern library, with plenty of documentation.

Anne’s Blog

Anne is documenting his process of going https:

  1. TLS: first steps
  2. TLS: issues with StartSSL
  3. TLS: issues with DreamHost
  4. TLS: deploy HSTS
  5. TLS: next steps

I’m really glad he’s doing this.

GitHub’s CSS · @mdo

Mark Otto talks through the state of Github’s CSS and the processes behind updating it. There’s a nice mix of pragmatism and best practices, together with a recognition that there’s always room for improvement.

DevDocs

A handy one-stop-shop for documentation on web technologies.

Just Solve the Problem Month 2012: Nitty Gritty « ASCII by Jason Scott

Jason goes into detail describing the File Format problem that he and others are going to tackle in the effort known as Just Solve The Problem.

InstaCSS | Instant CSS Documentation Search

A fantastically useful resource! Don’t let the name fool you: this provides instant access to documentation for CSS and HTML and JavaScript!

Put this one on speed dial.

HTML5 — Edition for Web Developers

A beautifully readable subset of the HTML spec, with an emphasis on writing web apps (and with information intended for browser makers has been removed). Very handy indeed!

Timed tracks - WHATWG Wiki

Hixie needs your help. Document examples of augmented video (or audio) such as captioned or subtitled media.

HTML5 Elements and Attributes

A very handy interface for browsing the contents of the HTML5 spec.

AJAX APIs Playground

A nice way to play around with Google's APIs. Example code is provided which you can edit and immediately see the results.

Main - browsersec - Google Code - Browser Security Handbook landing page

This looks like being an excellent—and free—resource "...meant to provide web application developers, browser engineers, and information security researchers with a one-stop reference to key security properties of contemporary web browsers."

Flickr Code

Hurrah! Flickr are sharing their code and here's the central repository.

CSS Compatibility and Internet Explorer

A very handy table of CSS support for versions of Internet Explorer from 5 to 8. Note that IE8 Beta 1 is listed separately to IE8.0.

jQuery 1.2 Cheat Sheet :: www.gscottolson.com/weblog/

A handy cheat sheet of jQuery methods to print out and keep on hand.

jQuery UI: Widgets, Components, and Interactions

From the people who brought you jQuery comes a set of widgets built using jQuery complete with documentation and tutorials.

Dear JavaScript Library Developers… - Wait till I come!

Christian's wish list for JavaScript libraries.

API - MetaWeather

I think it could be fun to mash up events (via location) with weather. This API would let me do that. How useful would it be to know what the weather would be like before coming to dConstruct, for instance?

Google Maps API Official Blog: Google Maps API Version 2

Version 2 of Google's Maps API is out. Changes, changes, read all about it.

Google Maps API Documentation

Documentation for the new Google Maps API. Unlike most web services, this one is run entirely over JavaScript.