Skip to content

Instantly share code, notes, and snippets.

View shilman's full-sized avatar
🇹🇼

Michael Shilman shilman

🇹🇼
View GitHub Profile
@shilman
shilman / RELEASE.md
Last active June 22, 2017 22:41
Storybook Release Proposal

Storybook Release Proposal

A Storybook release process based on Semver. In short:

  1. merge bugfix PRs directly into master automatically release (~daily)
  2. merge feature and breaking PRs into a release branch (e.g. release/3.2) and release features in groups along with a marketing push after a preview period (~monthly)

Motivation

During the Storybook 3.x transition we've undergone a series of growing pains as we've opened up the development process. We've had questions about:

@shilman
shilman / versioned_docs.md
Created June 25, 2017 23:20
Versioned Docs

Versioned Documentation for Storybook

Goals:

  • Docs for the latest stable release of Storybook, statically hosted at https://storybook.js.org
  • Docs for a preview release, clearly labeled as preview with disclaimers and pointers to the main docs
  • Docs for previous minor releases of Storybook, with disclaimers and pointers to the main docs

Proposal

Patterned off of Meteor docs site (source)

@shilman
shilman / RELEASE_SEMVER.md
Last active January 5, 2018 18:22
Storybook Revised Release Proposal

Storybook Release Proposal v2

A Storybook release proposal that combines Semver with marketing considerations. In short:

  1. multiple major versions per year
  2. blog post for each major version

Motivation

Earlier this year I proposed a release strategy that attempted to reduce major versions. We've been running with that strategy for six months and have released 3.0, 3.2, and 3.3 this way, but continue to get pushback on adhering to Semver. This proposal attempts to address those concerns and is inspired by Jest's versioning.

@shilman
shilman / storybook-roadmap-5.md
Last active March 6, 2018 06:42
Storybook Roadmap Meeting 5

Storybook Roadmap Meeting 5

attendees: @danielduan, @tmeasday, @shilman, @ndelangen

Release 3.4

  • feature freeze by @Hypnosphi
  • 3.4 alpha out today @shilman
  • 3.4 RC out this week @shilman
  • letter to our medium followers, tweet for testing
@shilman
shilman / withx.md
Last active April 12, 2018 13:39
withX strawman

WithX API proposal

Today's type system

type story = (context) => renderable
type decorator = (story, context) => renderable

For example:

@shilman
shilman / storybook-roadmap-2018-05-24.md
Created May 23, 2018 21:02
Storybook Roadmap 2018-05-24

Storybook Roadmap 2018-05-24

Some topics for tomorrow's meeting

  • Project update
    • New contributions
    • Stats
  • 4.0 Release
    • blocking
  • schedule
@shilman
shilman / Storybook Roadmap Notes 2018-05-24.md
Last active May 24, 2018 20:17
Storybook Roadmap Notes 2018-05-24
@shilman
shilman / test-package.md
Last active October 11, 2018 00:43
Publishing a test package

Wwhat I did to manually test some breaking changes to @storybook/cli by publishing a test-tagged package to NPM.

Publish package:

yarn bootstrap --reset --core
cd lib/cli
# edit package.json version: 4.0.0-alpha.24 => 4.0.0-test.25
npm publish --tag test --access public
@shilman
shilman / RELEASE_v4.md
Last active November 5, 2018 06:31
Storybook Release Proposal v4

Storybook Release Proposal v4

Fourth iteration of the Storybook release process (v1, v2, v3), updated to reflect learnings from the 4.0 release.

What we're doing now

  • We respect semver for all releases to the best of our ability
  • release/x.y (e.g. release/3.4) branch is released as a patch every week (e.g. 3.4.X)
  • master is released on the alpha tag every week (e.g. 4.0.0-alpha.X)