This "Getting Started" post is only likely to actually get you started if you're already familiar with Ruby, Heroku deployment basics, and Sinatra's dependencies.
There is nothing in this guide that lays out all of the components in the tool chain and explains which problems each tool is designed to solve.
Okay, so I should go to the component level to glean that, right? Well on the Sinatra site, there is nothing that explains the specific problems that Sinatra itself is designed to solve. The very first line of the Getting Started section of the Readme page says "Sinatra is a [some three letter acronym]"...with no indication of what that is or why I should want one.
The problem with that is I gain no insight whatsoever into whether the simple examples will translate to something I'd actually want to build. Without that, it literally makes no difference how great the toolchain might be. Exploring it is 100% opportunity cost vs. some shittier solution that actually explains itself more fully up front.
There is nothing in this guide that lays out all of the components in the tool chain and explains which problems each tool is designed to solve.
Okay, so I should go to the component level to glean that, right? Well on the Sinatra site, there is nothing that explains the specific problems that Sinatra itself is designed to solve. The very first line of the Getting Started section of the Readme page says "Sinatra is a [some three letter acronym]"...with no indication of what that is or why I should want one.
The problem with that is I gain no insight whatsoever into whether the simple examples will translate to something I'd actually want to build. Without that, it literally makes no difference how great the toolchain might be. Exploring it is 100% opportunity cost vs. some shittier solution that actually explains itself more fully up front.