johnnyreilly · johnnyreilly · Aug 28, 2023 · Aug 26, 2023 · Aug 27, 2023 · Aug 27, 2023
diff --git a/.gitignore b/.gitignore
@@ -1,4 +1,5 @@
 node_modules
 img.sh
 devto.sh
-APIClientGenerator
+APIClientGenerator
+.env
diff --git a/blog-website/blog/2012-01-07-standing-on-shoulders-of-giants/index.md b/blog-website/blog/2012-01-07-standing-on-shoulders-of-giants/index.md
@@ -3,6 +3,7 @@ slug: standing-on-shoulders-of-giants
 title: 'Standing on the Shoulders of Giants...'
 authors: johnnyreilly
 hide_table_of_contents: false
+description: 'John starts a blog inspired by Scott Hanselman to share useful tools and techniques for web development.'
 ---
 
 It started with Scott Hanselman. I had no particular plans to start a blog at all. However, I was reading Scott Hanselman's turn of the year [post](http://www.hanselman.com/blog/YourBlogIsTheEngineOfCommunity.aspx) and I was struck with an idea.

diff --git a/blog-website/blog/2012-01-14-jqgrid-its-just-far-better-grid/index.md b/blog-website/blog/2012-01-14-jqgrid-its-just-far-better-grid/index.md
@@ -4,6 +4,7 @@ title: "jqGrid - it's just a far better grid"
 authors: johnnyreilly
 tags: [jqgrid, ajax, jquery]
 hide_table_of_contents: false
+description: 'jqGrid is a sleek & efficient grid component for ASP.NET projects. Its minimal data exchange between client and server impressed John no end.'
 ---
 
 The year was 2010 (not really that long ago I know) and the project that I was working on was sorely in need of a new grid component. It was an [ASP.NET WebForms](http://www.asp.net/web-forms) project and for some time we'd been using what was essentially a glorified [datagrid](http://msdn.microsoft.com/en-us/library/system.web.ui.webcontrols.datagrid.aspx) which had a few extra features implemented to allow us to change column order / columns displayed / copy contents to clipboard etc. Our grid worked perfectly fine - it gave us the functionality we needed. However, it looked pretty terrible, and had some "quirky" approaches in place for supporting IE and Firefox side by side. Also, at the time we were attempting to make our app seem new and exciting again for the users. The surprising truth is that users seem to be more impressed with a visual revamp than with new or amended functionality. So I was looking for something which would make them sit up and say "oooh - isn't it pretty!". Unfortunately the nature of the organisation I was working for was not one that lended itself to paying for components. They were occasionally willing to do that but the hoops that would have to be jumped through first, the forms that would need to be signed in triplicate by people that had nearly nothing to do with the project made that an unattractive prospect. So I began my search initially looking at the various open source offerings that were around. As a minimum I was looking for something that would do what our home-grown component did already (change column order / columns displayed / copy contents to clipboard etc) but hopefully in a "nicer" way. Also, I had long been unhappy with the fact that to get our current grid to render results we did a \***full postback**\* to the server and re-rendered the whole page. Pointless! Why should you need to do all this each time when you only wanted to refresh the data? Instead I was thinking about using an [Ajax](http://en.wikipedia.org/wiki/Ajax_%28programming%29) approach; a grid that could just get the data that it needed and render it to the client. This seemed to me a vastly "cleaner" solution - why update a whole screen when you only want to update a small part of it? Why not save yourself the trouble of having to ensure that all other screen controls are persisted just as you'd like them after the postback? I also thought it was probably something that would scale better as it would massively reduce the amount of data moving backwards and forwards between client and server. No need for a full page life cycle on the server each time the grid refreshes. Just simple data travelling down the pipes of web. With the above criteria in mind I set out on my Google quest for a grid. Quite soon I found that there was a component out there which seemed to do all that I wanted and far more besides. It was called [jqGrid](http://www.trirand.com/blog/):

diff --git a/blog-website/blog/2012-01-24-what-on-earth-is-jquery-and-why-should/index.md b/blog-website/blog/2012-01-24-what-on-earth-is-jquery-and-why-should/index.md
@@ -4,6 +4,7 @@ title: 'What on earth is jQuery?  And why should I care?'
 authors: johnnyreilly
 tags: [jqgrid, ajax, jquery]
 hide_table_of_contents: false
+description: 'What is jQuery? Discover the truth about the JavaScript library thats taking the web development world by storm - its simply brilliant!'
 ---
 
 What on earth is jQuery? What's a jQuery plugin?

diff --git a/blog-website/blog/2012-01-30-javascript-getting-to-know-beast/index.md b/blog-website/blog/2012-01-30-javascript-getting-to-know-beast/index.md
@@ -4,9 +4,10 @@ title: 'JavaScript - getting to know the beast...'
 authors: johnnyreilly
 tags: [javascript, c#]
 hide_table_of_contents: false
+description: 'Discovering jQuery and advice from Elijah Manor and Douglas Crockford changes Johns initial dislike of JavaScripts quirks.'
 ---
 
-So it's 2010 and I've started using jQuery. jQuery is a JavaScript library. This means that I'm writing JavaScript... Gulp! I should say that at this point in time I \***hated**\* JavaScript (I have mentioned this previously). But what I know now is that I barely understood the language at all. All the JavaScript I knew was the result of copying and pasting after I'd hit "view source". I don't feel too bad about this - not because my ignorance was laudable but because I certainly wasn't alone in this. It seems that up until recently hardly anyone knew anything about JavaScript. It puzzles me now that I thought this was okay. I suppose like many people I didn't think JavaScript was capable of much and hence felt time spent researching it would be wasted. Just to illustrate where I was then, here is 2009 John's idea of some pretty "advanced" JavaScript:
+So it's 2010 and I've started using jQuery. jQuery is a JavaScript library. This means that I'm writing JavaScript... Gulp! I should say that at this point in time I **hated** JavaScript (I have mentioned this previously). But what I know now is that I barely understood the language at all. All the JavaScript I knew was the result of copying and pasting after I'd hit "view source". I don't feel too bad about this - not because my ignorance was laudable but because I certainly wasn't alone in this. It seems that up until recently hardly anyone knew anything about JavaScript. It puzzles me now that I thought this was okay. I suppose like many people I didn't think JavaScript was capable of much and hence felt time spent researching it would be wasted. Just to illustrate where I was then, here is 2009 John's idea of some pretty "advanced" JavaScript:
 
 <!--truncate-->
 

diff --git a/blog-website/blog/2012-02-05-potted-history-of-using-ajax-on/index.md b/blog-website/blog/2012-02-05-potted-history-of-using-ajax-on/index.md
@@ -4,6 +4,7 @@ title: 'A Potted History of using Ajax (on the Microsoft Stack of Love)'
 authors: johnnyreilly
 tags: [ajax, jquery, json, microsoft]
 hide_table_of_contents: false
+description: 'Discovering Ajax and JSON transformed Johns approach to programming by lifting limitations and improving performance.'
 ---
 
 This post originally started out as an explanation of JSON. However as I wrote this quickly got abandoned in favour of writing about how I came to use JSON in the first place - which was through the use of Ajax. Having written a goodly amount I've now decided to move the actual JSON stuff into another post since I think Ajax is probably worth thinking about by itself rather than as an aside. So let me start at the beginning and explain how I came to use Ajax in the first place (this may take some time so please bear with me). In late 2004 I first started working on a project which I was to remain involved with (on and off) for a very long time indeed. The project was part financial reporting system and part sales incentivisation tool; it was used internally in the investment bank in which I was working. The project had been in existence for a number of years and had a web front end which at that point would been built in a combination of HTML, JavaScript, classic ASP and with a Visual Basic 6.0 back end. One of the reasons I had been brought on to the project was to help ".Net-ify" the thing and migrate it to ASP.NET and C#. I digress. The interesting thing about this app was that there were actually some quite advanced things being done with it (despite the classic ASP / VB). The users could enter trades into the system which represented actual trades that had been entered into a trading system elsewhere in the organisation. These trades would be assigned a reporting value which would be based on their various attributes. (Stay with me people this will get more interesting I \***promise**\*.) The calculation of the reporting value was quite an in depth process and needed to be performed server-side. However, the users had decreed that it wasn't acceptable to do a full postback to the server to perform this calculation; they wanted it done "on-the-fly". Now if you asked me at the time I'd have said "can't be done". Fortunately the other people working on the project then weren't nearly so defeatist. Instead they went away and found Microsoft's [webservice.htc](http://msdn.microsoft.com/en-us/library/ie/ms531033%28v=vs.85%29.aspx) library. For those of you that don't know this was a JavaScript library that Microsoft came up with to enable the access of Web Services on the client. Given that it was designed to work with IE 5 I suspect it was created between 1999-2001 (but I'm not certain about that). Now it came as a revelation to me but this was a JavaScript library that talked to our web services through the medium of XML. In short it was my first encounter with anything remotely [Ajax](<http://en.wikipedia.org/wiki/Ajax_(programming)>)\-y. It was exciting! However, the possibilities of what we could do didn't actually become apparent to me for some years. It's worth saying that the way we were using webservice.htc was exceedingly simplistic and rather than investigating further I took the limited ways we were using it as indications of the limitations of Ajax and / or webservice.htc. So for a long time I thought the following: - The only way to pass multiple arguments to a web service was to package up arguments into a single string with delimiters which you could [split](<http://en.wikipedia.org/wiki/Comparison_of_programming_languages_(string_functions)#split>) and unpackage as your first step on the server.

diff --git a/blog-website/blog/2012-02-15-wcf-transport-windows-authentication/index.md b/blog-website/blog/2012-02-15-wcf-transport-windows-authentication/index.md
@@ -4,6 +4,7 @@ title: 'WCF Transport Windows authentication using NetTcpBinding in an Intranet
 authors: johnnyreilly
 tags: [WCF, Authentication]
 hide_table_of_contents: false
+description: 'John explains authentication issues when migrating from .NET Remoting to WCF. The post highlights a security feature and suggests solutions.'
 ---
 
 ## Update

diff --git a/blog-website/blog/2012-02-23-joy-of-json/index.md b/blog-website/blog/2012-02-23-joy-of-json/index.md
@@ -4,6 +4,7 @@ title: 'The Joy of JSON'
 authors: johnnyreilly
 tags: [json]
 hide_table_of_contents: false
+description: 'JSON is a lightweight data format that helps create and read JavaScript objects. This article traces its discovery and explains its usefulness.'
 ---
 
 So back to JSON. For those of you that don't know JSON stands for JavaScript Object Notation and is lightweight text based data interchange format. Rather than quote other people verbatim you can find thorough explanations of JSON here: - [Introducing JSON](http://www.json.org/)

diff --git a/blog-website/blog/2012-03-03-jquery-unobtrusive-remote-validation/index.md b/blog-website/blog/2012-03-03-jquery-unobtrusive-remote-validation/index.md
@@ -4,6 +4,7 @@ title: 'jQuery Unobtrusive Remote Validation'
 authors: johnnyreilly
 tags: [jquery, jquery validation, jquery unobtrusive validation]
 hide_table_of_contents: false
+description: 'Learn how to do remote validation with unobtrusive data attributes in ASP.NET MVC. Block validation and re-evaluate it with this hacky solution.'
 ---
 
 Just recently I have been particularly needing to make use of remote / server-side validation in my ASP.NET MVC application and found that the unobtrusive way of using this seemed to be rather inadequately documented (of course it's possible that it's well documented and I just didn't find the resources). Anyway I've rambled on much longer than I intended to in this post so here's the TL;DR:

diff --git a/blog-website/blog/2012-03-12-striving-for-javascript-convention/index.md b/blog-website/blog/2012-03-12-striving-for-javascript-convention/index.md
@@ -4,13 +4,16 @@ title: 'Striving for (JavaScript) Convention'
 authors: johnnyreilly
 tags: [javascript]
 hide_table_of_contents: false
+description: 'Visual Studio 11 beta resolved issues. John has moved away from Hungarian Notation but retained using "$" as a prefix for jQuery objects.'
 ---
 
 ## Update
 
+The speed of change makes fools of us all. Since I originally wrote this post all of 3 weeks ago Visual Studio 11 beta has been released and the issues I was seeking to solve have pretty much been resolved by the new innovations found therein. It's nicely detailed in [@carlbergenhem](http://www.twitter.com/carlbergenhem)'s blog post: [My Top 5 Visual Studio 11 Designer Improvements for ASP.NET 4.5 Development](https://blogs.telerik.com/blogs/posts/12-03-26/my-top-5-visual-studio-11-designer-improvements-for-asp-net-4-5-development.aspx). I've left the post in place below but much of what I said (particularly with regard to Hungarian Notation) I've now moved away from. That was originally my intention anyway so that's no bad thing. The one HN artefact that I've held onto is using "$" as a prefix for jQuery objects. I think that still makes sense. I would have written my first line of JavaScript in probably 2000. It probably looked something like this: `alert('hello world')`. I know. Classy. As I've mentioned before it was around 2010 before I took JavaScript in any way seriously. Certainly it was then when I started to actively learn the language. Because up until this point I'd been studiously avoiding writing any JavaScript at all I'd never really given thought to forms and conventions. When I wrote any JavaScript I just used the same style and approaches as I used in my main development language (of C#). By and large I have been following the .net naming conventions which are ably explained by Pete Brown [here](http://10rem.net/articles/net-naming-conventions-and-programming-standards---best-practices). Over time I have started to move away from this approach. Without a deliberate intention to do so I have found myself adopting a different style for my JavaScript code as compared with anything else I write. I wouldn't go so far as to say I'm completely happy with the style I'm currently using. But I find it more helpful than not and thought it might be worth talking about. It was really 2 things that started me down the road of "rolling my own" convention: dynamic typing and the lack of safety nets. Let's take each in turn....
+
 <!--truncate-->
 
-The speed of change makes fools of us all. Since I originally wrote this post all of 3 weeks ago Visual Studio 11 beta has been released and the issues I was seeking to solve have pretty much been resolved by the new innovations found therein. It's nicely detailed in [@carlbergenhem](http://www.twitter.com/carlbergenhem)'s blog post: [My Top 5 Visual Studio 11 Designer Improvements for ASP.NET 4.5 Development](https://blogs.telerik.com/blogs/posts/12-03-26/my-top-5-visual-studio-11-designer-improvements-for-asp-net-4-5-development.aspx). I've left the post in place below but much of what I said (particularly with regard to Hungarian Notation) I've now moved away from. That was originally my intention anyway so that's no bad thing. The one HN artefact that I've held onto is using "$" as a prefix for jQuery objects. I think that still makes sense. I would have written my first line of JavaScript in probably 2000. It probably looked something like this: `alert('hello world')`. I know. Classy. As I've mentioned before it was around 2010 before I took JavaScript in any way seriously. Certainly it was then when I started to actively learn the language. Because up until this point I'd been studiously avoiding writing any JavaScript at all I'd never really given thought to forms and conventions. When I wrote any JavaScript I just used the same style and approaches as I used in my main development language (of C#). By and large I have been following the .net naming conventions which are ably explained by Pete Brown [here](http://10rem.net/articles/net-naming-conventions-and-programming-standards---best-practices). Over time I have started to move away from this approach. Without a deliberate intention to do so I have found myself adopting a different style for my JavaScript code as compared with anything else I write. I wouldn't go so far as to say I'm completely happy with the style I'm currently using. But I find it more helpful than not and thought it might be worth talking about. It was really 2 things that started me down the road of "rolling my own" convention: dynamic typing and the lack of safety nets. Let's take each in turn.... ### 1\. Dynamic typing
+### 1\. Dynamic typing
 
 Having grown up (in a development sense) using compiled and strongly-typed languages I was used to the IDE making it pretty clear what was what through friendly tooltips and the like:
 
@@ -110,7 +113,3 @@ I really rather like this approach and I'm thinking about starting to adopt it.
 Despite being quite used to writing unit tests for all my server-side code I have not yet fully embraced unit testing on the client. Partly I've been holding back because of the variety of JavaScript testing frameworks available. I wasn't sure which to start with. But given that it is so easy to introduce bugs into JavaScript I have come to the conclusion that it's better to have some tests in place rather than none. Time to embrace the new. ## Conclusion
 
 I've found using Hungarian Notation useful whilst working in JavaScript. Not everyone will feel the same and I think that's fair enough; within reason I think it's generally a good idea to go with what you find useful. However, I am giving genuine consideration to moving to the DOJO style and moving back to my more standard camel-cased variable names instead of Hungarian Notation. Particularly since I strive to keep my functions short with the view that ideally each should 1 thing well. Keep it simple etc... And so in a perfect world the situation of forgetting a variables purpose shouldn't really arise... I think once I've got up and running with JavaScript unit tests I may make that move. Hungarian Notation may have proved to be just a stop-gap measure until better techniques were employed...
-
-```
-
-```
diff --git a/blog-website/blog/2012-03-17-using-pubsub-observer-pattern-to/index.md b/blog-website/blog/2012-03-17-using-pubsub-observer-pattern-to/index.md
@@ -4,6 +4,7 @@ title: 'Using the PubSub / Observer pattern to emulate constructor chaining with
 authors: johnnyreilly
 tags: [javascript]
 hide_table_of_contents: false
+description: 'Pass objects between JavaScript files using PubSub interface to achieve code reusability without global scope pollution. No prototypes needed.'
 ---
 
 Yes the title of this post is \***painfully**\* verbose. Sorry about that. Couple of questions for you: - Have you ever liked the way you can have base classes in C# which can then be inherited and subclassed <u>in a different file / class</u>

diff --git a/blog-website/blog/2012-03-22-wcf-moving-from-config-to-code-simple/index.md b/blog-website/blog/2012-03-22-wcf-moving-from-config-to-code-simple/index.md
@@ -4,6 +4,7 @@ title: 'WCF - moving from Config to Code, a simple WCF service harness (plus imp
 authors: johnnyreilly
 tags: [WCF, authorization]
 hide_table_of_contents: false
+description: 'John describes his approach to developing a Windows Service-hosted WCF service/client harness, including locking down WCF authorization.'
 ---
 
 Last time I wrote about WCF I was getting up and running with [WCF Transport Windows authentication using NetTcpBinding in an Intranet environment](../2012-02-15-wcf-transport-windows-authentication/index.md). I ended up with a WCF service hosted in a Windows Service which did pretty much what the previous post name implies.

diff --git a/blog-website/blog/2012-04-05-making-pdfs-from-html-in-c-using/index.md b/blog-website/blog/2012-04-05-making-pdfs-from-html-in-c-using/index.md
@@ -4,6 +4,7 @@ title: 'Making PDFs from HTML in C# using WKHTMLtoPDF'
 authors: johnnyreilly
 tags: [wkhtmltopdf, c#, pdf]
 hide_table_of_contents: false
+description: 'Create PDF reports from HTML with WKHTMLtoPDF, an open source tool that renders web pages to PDF, using a simple wrapper class.'
 ---
 
 ## Updated 03/01/2013