Skip to content
A new way to do tutorial blogging—with git!
CoffeeScript CSS JavaScript Ruby
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
config
lib
logs
public/javascripts
sass
spec
views
.gitignore
LICENSE
README.md
app.coffee
config.rb
default.json
dev-server.coffee
package.json

README.md

Sophocles

Sophocles is a re-imagining of our approach to writing tutorial blogs. Typically, we see text interspersed with code. It can be hard to focus on the changes, sometimes, or to see them out of context. With Sophocles, I realized that git was an ideal tool for describing sets of changes. With some small adjustments to how we use git itself, we can make the elements of a set of git commits a tutorial.

When using Sophocles, every commit is one “step” in your tutorial. The changes in the commit are the changes for that step, and the commit message is the description of what those changes do. Sophocles then formats these in a way that is easy to read.

Sophocles is a Node.js application. The intent is for it to be easily deployed to heroku so anyone can run a Sophocles blog. Not quite there yet, but work is ongoing in my spare time!

License

Sophocles is provided under the terms of the MIT License. See the LICENSE file in this same directory.

Author

Sophocles is copyright me, Antonio Salazar Cardozo, and licensed uner the terms of the MIT License. No warranties are made, express or implied. See the LICENSE file in this same directory for more details.

I have a rather sporadically updated blog at http://shadowfiend.posterous.com/.

I am the Chief Software Engineer at OpenStudy, where we're working on changing the face of education as we know it using Scala, Lift, and a variety of other tools.

Something went wrong with that request. Please try again.