In the small collection of reusable text in /_common/, I can draft some general-purpose reminder to the reader to customize sample code before attempting to run it. Then we can look around for places, probably many, to plug that in.

From: Ruben Orduz <notifications@github.com<mailto:notifications@github.com>>
Reply-To: "rackerlabs/developer.rackspace.com" <reply@reply.github.com<mailto:reply@reply.github.com>>
Date: Monday, June 2, 2014 at 4:25 PM
To: "rackerlabs/developer.rackspace.com" <developer.rackspace.com@noreply.github.com<mailto:developer.rackspace.com@noreply.github.com>>
Cc: Rose Coste <rose.coste@rackspace.com<mailto:rose.coste@rackspace.com>>
Subject: Re: [developer.rackspace.com] incorporate feedback on consistency of SDK Quickstart with API doc (#290)


In src/docs/cloud-dns/getting-started/samples/create_record.rst:

> @@ -5,7 +5,7 @@
>  .. code-block:: javascript
>
>    var recDetails = {
> -    name: 'app.domain.com',
> +    name: 'app.example.com',


Yes, unfortunately, copy-paste is rampant. Sometimes I've posted stuff in StackOverflows with pretty obvious placeholders and have gotten negative responses because the code didn't run. Same with stuff I've posted in my personal blog and get pretty heated comments about how garbage the examples are because it doesn't run as-is. So yes, lesson learned, avoid implicit placeholders, no matter how obvious they seem.

—
Reply to this email directly or view it on GitHub<https://github.com/rackerlabs/developer.rackspace.com/pull/290/files#r13308161>.