gido / slides-design-documentation-made-to-last

Build Design Documentation Made to Last

Home Page:https://zufrieden.github.io/slides-design-documentation-made-to-last/#/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Build Design Documentation Made to Last - slides by Marc Friederich

  1. Me
  • Marc Friederich, software designer, Antistatique
  • @Zufrieden on twitter/github
  1. Introduction
  • Start to love Documentation
  • Sustainable approach!
  • Design should be documented as well
  1. Concepts
  • What is design? I mean really!
  • The Law of Leaky Abstractions
    • Bootstrap developers :-(
  • Technical debt
    • Every decision you make ... you may increase the debt
  • Design systems
    • :-)
  • Progressive enhancement - Joy of Web
  • This means that not everyone will experience the same visual design. This is not a bug. This is a feature of the web.
  1. Web all the things!
  • Styleguide first approach
  • Product development, styleguide less-more frontend oriented
  • A11Y!
  • Open!
  1. What we've learned from building swiss styleguide, and now Vaud
  • Tell the story ;-)
  • Going faster in the browser
  • Rationalize design (component matrix)
  • Discussion (Accessibility/Ethics/Visual/Technical)
  1. Takaways
  • Plan your work acceptation ahead
  • Documentation is fun!
  • Designing your design system is important
  • Reduce technical debt
  • Get your hands dirty, brake abstraction law!

Sources


Installation

Some reveal.js features, like external markdown and speaker notes, require that presentations run from a local web server. The following instructions will set up such a server as well as all of the development tasks needed to make edits to the reveal.js source code.

  1. Install Yarn

  2. Install Grunt

  3. Clone this repository

  4. Install dependencies

    $ yarn
  5. Serve the presentation and monitor source files for changes

    $ grunt serve
  6. Open http://localhost:8000 to view your presentation

    You can change the port by using grunt serve --port 8001.

Attributions

Presentation built with Reveal.js

About

Build Design Documentation Made to Last

https://zufrieden.github.io/slides-design-documentation-made-to-last/#/

License:MIT License


Languages

Language:JavaScript 48.2%Language:CSS 38.5%Language:HTML 13.2%