the staging site

Pat, pat. And here’s a marvellous convenient place
for our rehearsal. This green plot shall be our
stage, this hawthorn-brake our tiring-house, and we
will do it in action as we will do it before the duke.
A Midsummer Night’s Dream

This document describes the creation and configuration of a staging site for willshake.

1 motivation

A staging site is a kind of “rehearsal” area for a web site. And like theatrical rehearsals, staging sites can serve different purposes, from trying out new ideas to flushing out technical bugs.

For willshake, the staging site falls more on the “new ideas” end. Willshake is specially designed to support the addition and removal of features. Features may be in development for a long time before making it into production.

2 configuration

The staging site should be as close as possible to the production site.

All of the work that was done to make the live site easy to deploy, applies here.

Of course, the hostname will be different.

Should we even bother with an http staging site?

<VirtualHost *:80>

</VirtualHost>

In theory, you can do this by calling the one-time setup script with a different hostname.

server/one-time_setup staging.willshake.net

3 secure the staging site

Yeah, and add secure staging.

4 the staging site is private

I’ll privily away. I love the people,
But do not like to stage me to their eyes.
Measure for Measure

I’m not 100% decided on this. Part of the objective of the staging site is to be able to share incomplete features with people, to get feedback before they go into production. But there’s a risk in publishing what is in many ways a duplicate of the “real” site.

So certainly, the staging site must not be indexed. I somehow need to create a robots.txt that hides everything, but without ever letting it get to production.

about willshake

Project “willshake” is an ongoing effort to bring the beauty and pleasure of Shakespeare to new media.

Please report problems on the issue tracker. For anything else, public@gavinpc.com

Willshake is an experiment in literate programming—not because it’s about literature, but because the program is written for a human audience.

Following is a visualization of the system. Each circle represents a document that is responsible for some part of the system. You can open the documents by touching the circles.

Starting with the project philosophy as a foundation, the layers are built up (or down, as it were): the programming system, the platform, the framework, the features, and so on. Everything that you see in the site is put there by these documents—even this message.

Again, this is an experiment. The documents contain a lot of “thinking out loud” and a lot of old thinking. The goal is not to make it perfect, but to maintain a reflective process that supports its own evolution.

graph of the program

about

Shakespeare

An edition of the plays and poems of Shakespeare.

the works