Coding For a Living

rss

A place to share and comment about coding for a living.


vRAD Well Known Names– Part 3 Mike McIntyre

In my two previous vRAD posts I explained the concept of well known names and introduced ‘PostalCode’, a well known name I have used for application development since 1992.

  Coding For a Living xRAD Well Known Names– Part 1
  Coding For a Living vRAD Well Known Names– Part 2

At the end of my last xRAD post I asked: Can you think of at least three more ways the well known word PostalCode helps us build applications rapidly?

Here are a few of many correct answers:

  1. Reduces code review time. PostalCode classes and class members which encapsulate data and behavior, were last changed in 2004.
  2. Reduces testing time; PostalCode classes and class members which encapsulate data and behavior, were last tested in 2004.
  3. Avoids elusive names that are open to subjective interpretation.
  4. Promotes self-documenting code and reduces code comments.
  5. Provides a common name across the tiers of a multi-tier application.
  6. Makes it possible to document legacy systems faster.

 

In three posts I have explained the concept of well known names and how a single well known name can speed up application development by promoting re use over new development.image

Since 1992 we have developed 1513 well known names. Examples are:  PhoneNumber, EmailAddress, City, State, Country, Customer, FirstName, LastName, Contact, Url, Product, UnitOfMeasure.

Our well known names are used in schema scripts for databases, in models, in code, generators, in documentation, and much more.  We have code snippets for every well known name.

When we start a new project an average of 88% of the names we need come from our well known names.

In future posts I will explain how the ‘well known’ concept applies to other things used for application development; things like ‘well known tables’, well known methods, well known constants, and more.


vRAD Well Known Names– Part 2 Mike McIntyre

This post explains several ways well known names help my company build applications rapidly.

In my previous vRAD post I introduced ‘PostalCode’, a well known name I have used for application development since 1992.

In our development world, the well known word PostalCode is used where ever a zip code, post code, or postal code is represented or stored, for example:

1. as the column name of all database table columns that store a zip code, post code, or postal code

2. in data models where ever a zip code, post code, or postal code is used

3. as the property name in all classes that require a zip code, post code, or postal code

4. in programmer documentation

5. in code and other generators

PostalCode helps build applications rapidly because it reduces development and development project time.

How? Reuse. Reuse as in where the same thing is used again for the same function – again, and again, and again.  Since 1992:

1. No design time has been spent coming up with what to name things that will represent or store zip codes, post codes, or postal codes.

2. Programmer documentation about PostalCode has not been changed since 1992.

3. Anyone who has worked for me for more than a couple of months can teach a new person to use PostalCode because it is – you guessed it – well known.

4. Code generators, which require postal codes, post codes, or zip codes - for schemas, models, code, and tests – used the well known name PostalCode. We never spend time modifying that part of our code generators.

Can you think of at least three more ways the well known word PostalCode helps us build applications rapidly?

Answers will be published in the next xRad blog post..


xRAD Well Known Names– Part 1 Mike McIntyre

 

Well known names are part my rapid application development (xRAD) frame work. In this blog post I introduce a well known name that has helped me, since 1992, to rapidly develop applications for my clients.

In 1992 I decided PostalCode would be the well known name I would use for: postal code, post code,and zip code.

Zip code, post code, and postal code are different names for the same thing - a code that is appended to the end of addresses to make it possible to quickly sort mail.

PostalCode is consistently used in my databases, models, code, generators, snippets, control names – anywhere one of my applications uses a zip code, post code, or postal code.

Stay tuned for my next XRAD blog post in which I will explain how a well known name like PostalCode contributes to rapid application development.