Sedition·com 3.0 routes and design document

Sedition·com 3.0 routes and design document

Wednesday, 23 February 2011—subject to ongoing, unnanounced updates

Modern Perl Modern Perl at Powell’s, Modern Perl at Barnes and Noble, Modern Perl at, or download Modern Perl for free and then recommend it to your friends, write a great review, or otherwise spread the word.

3.0 functionality

ElektrumPress, current candidate/prototype. What’s the matter? Don’t you get it?

Status: draft, deleted, publish; how does this jibe with scheduling and display targets?
Type: article, fragment, asset, comment; with this simple approach nodes can serve any purpose.

Should be some way to extend this so that nodes can serve… Or perhaps the same as the FTL model. No titles at all. Everything is just content. Same side issues though… just conceptually cleaner.


Home page, whatever that will mean.
GET⇢ List of articles.
POST⇢ Create an article.
PUT⇢ Create an article.
Individual view, including possible follow up comments and discussion.
Individual view of unpublished node for those with permission.
View a list of diffs for a node.
View a particular diff.
Individual view of unpublished node by rules associated with token; e.g. timespan, no edits, IP.
Visit random node.
List view of articles by tag(s).
Visit random node from tag list.
Form which posts to link.
Search the site. Terms may be passed in as the param q instead.
Index of users? Personal page if signed-in?
User view.
User settings and preferences.
Form to create or associate account.
Supported account creation–
  • Native.
  • OpenID.
  • …?
Confirm a native registration, reset a password, etc, etc, etc.
Clears session.
User settings and preferences.
Net::DAV::Server based interface to the root tree.
Anonymous too.
Dump of the context’s configuration.
Not spec’d. Config::Crontab based interface?
Experimental, dangerous interface for raw SQL content dumps.
Plain text %INC dump.
Pings alla
Most resources can take this suffix for an Atom feed.
GET⇢ Nice URI index.
POST⇢ new nice URI; redirects to /admin/niceuri/{string}.
View/edit a nice URI; should validate it’s allowed by checking actions against it.

Authentication realms

Native with Eks,Bcrypt

New features from 2.0


  • As much in place editing as possible; sensible.
  • Application dumping of static files on demand, like a 404 page to plug into a web engine.
  • Arbitrary, autocomplete tagging of articles.
  • Token preview URIs so that previews may be shared.
  • Insert table of contents checkbox for view. Parses major tags and perhaps takes a setting for how deep to go.


Look into needs for DoubleClick and BlogAds and cater to it.


Meta features to add/formalize

  • Pod viewer and perldoc interface.
  • Machine introspection.
  • Deployment with Starman or similar tool with web interface.

Static issues…

  • Error docs.
  • cross-domain.xml
  • favicon.ico.
  • 1x1 gif instructions for most servers and optimization where not possible?



  • Starman could be self-HUPing… How to sanity check that you’re not about to crash your server?

Edit links have token so that you can pop a “This {node} has been edited since you came from this link. Perhaps you should view it to see its current state.”

Functional notes

  • Display name is not unique; this is necessary because the origin of the account can vary and because it’s just reality. Names are duplicated. Local usernames can be constrained.
  • Usernames are not allowed to be purely numeric; this affords /user/{name|id}.
  • Cache clearance should cascade for related nodes.