Page 19 of 23
Documentation in Ruby on Rails apps tends to be somewhat of a hit-and-miss affair, particularly within non-product organizations. In this blog post, I’ll run through how Tomdoc has helped my code become clearer and easier to maintain, with very little overhead. First, a small explanation about Tomdoc. It is effectively a spec that dictates a way of writing inline documentation...
This morning I wrote a quick script that I found quite handy - it takes a CSV file, and adds cards to Trello from it’s contents. At 3months, we quite regularly get long spreadsheets with requirements, so this script saves us a lot of time when we need to import these lists into cards so we can estimate and expand...
For the last week after deploying my new blog to joshmcarthur.com instead of a ‘blog’ subdomain, and implementing a new design and back-to-basics blogging engine, I’ve noticed that my markdown wasn’t being parsed properly (/at all). Originally this was hard to spot - my posts had been migrated from Blogger, to Tumblr, out of Tumblr, transformed from HTML to Markdown,...
When Twitter Bootstrap first shipped, it came with a couple of handy integrations with external jQuery plugins. Once of the more popular of these integrations was styles that were compatible with the classes, elements and attributes added by jQuery Tablesorter. Recently, however, these integrations have been removed from Bootstrap, as it was felt that they were distracting from the core...
Last night I quickly patched together a command called git-browse - it’s a small but handy extension to git that looks at the remotes you have set up inside a repository, and opens up the first Github repository it finds - to give an example: -> git remote -v origin [email protected]:joshmcarthur/WriteIdeally.git (fetch) origin [email protected]:joshmcarthur/WriteIdeally.git (push) heroku [email protected]:writeideally.git (fetch) heroku [email protected]:writeideally.git...
The Backend This article first is in a series of three blog posts documenting how I created TreatMe Lite, an HTMl5 web app using Zepto.js, Coffeescript, and a range of other frameworks and tools, all backed by an Express JS web service. See my previous post for more information about the application. Last post (the intro), I left off explaining...
For a long time, I’ve been looking to move into the NodeJS trend that’s been taking the development community by storm. The problem is that coming from a Rails development background, and my inability to follow callbacks through more than 2 levels, has lead to my previous efforts to end in broken code and frustration. Happily, however, I took another...
Tonight I’d like to talk about a project I’ve been working on in my spare time for the last few months. I’m super excited to see it coming together, and it’s nearly ready to go live. The application is called RateMyCourses - put simply, it’s a way for University students to explore, rate, and comment on courses they’ve done to...
When I’m working on a site, or analysing somebody else’s, I often wish that jQuery was loaded into that page - it’s an unbeatable tool for really digging into the site’s source to debug something or work out how something has been done. To help out with this, I’ve put together a quick bookmarket, similar to the more fun one...
Here at 3Months, we have a couple of monolithic projects that have been around for yonks - because of this, they don’t have bundler set up, and many of them have incomplete or out-of-date gem requirements. Yesterday I needed to get one of these projects set up locally for the first time, so I was kindly lent the output of...