The Website Development Guide
The Website Development Guide
THE
WEBSITE
DEVELOPMENT
BRIEF
Joint guidelines and template for business owners, to enable more effective working with
web development agencies/companies.
Supported by:
DISCLAIMER:
Whilst every effort has been made to ensure the accuracy of the information/material contained in this
document, the author and the Local Enterprise Office assume no responsibility for and give no guarantees,
undertakings or warranties concerning the accuracy, completeness or up to date nature of the information
provided in this guide and do not accept any liability whatsoever arising from any errors or omissions.
The Website Development Brief
… a best practice guide to briefing web development agencies
This guide came about because my local enterprise office encountered a very common
concern. Their client companies were spending huge chunks of their budgets on what
often ended up being non-functioning, incomplete or disappointing website projects. I
have suffered this pain myself despite my computer science qualifications, and I’ve seen
many of the 200+ small business owners I’ve mentored and coached fall into the same
trap. Perhaps you think you are not one of ‘those people’ but believe me, we can all find
ourselves in that predicament.
Five years ago I established a business specifically to tackle this dilemma, so I was
delighted to be asked to produce this guide. It affords me the opportunity to take what
I’ve learned, tested and refined and place it in the hands of as many other small business
owners as possible.
Whilst a guide like this can never be totally comprehensive, it will cover the major areas
that you need to put down in writing before starting a website development project. I
hope it will be an invaluable resource that helps you formulate your brief for web
development agencies/companies.
It relies on the premise that to maximise your chance of success, your eventual
development partner needs to know where you are now. And they need to know where
you want to get to, what success will look like for you, and how it will be measured.
Above all else, you need to make that crystal clear. If you can do that you’ll find that most
agencies/companies will be pretty good at getting you where you want to go.
That is where the ‘brief’ comes in – it is the best way to capture the pertinent
information concisely, yet comprehensively, so everyone will be singing off the same
hymn sheet.
If there are other members of your business whose perspective will enrich your project
brief, and will ensure it is as comprehensive as you can make it, then it is a excellent idea
to involve them.
Don’t cut corners here. The problems that result will take many times longer and cost
many times more to rectify. A rule of thumb us old-school software developers used was
to spend 20% of the total time/budget of any project getting the requirements well
documented. That is my challenge to you.
Patricia O’Sullivan
https://ie.linkedin.com/in/pattios
P.S. If you want to skip sections of the suggested brief so be it, perhaps they are unsuited to
your project, but more likely it’s because you can’t be bothered to complete them. On your
head be it!
i
The Website Development Brief
… a best practice guide to briefing web development agencies
1. A BETTER JOB
A brief is the single most important piece of information you can prepare. It’s from this
that everything else flows. The supplier cannot be expected to read your mind or know
everything you do; therefore it’s essential that every effort be taken to prepare the best
possible documentation of what is required.
Giving the tightest of parameters to creative thinkers (and that’s what web developers
are) will often stimulate the most creative of outcomes. You need to stimulate their
creative imagination, not restrict it. Ultimately you are buying their creativity, but you
want that creativity to be focused in the correct direction. That’s why your brief should
be a starting point; discovering halfway through the project that they are headed in the
wrong direction inevitably leads to both sides playing ‘the blame game’.
Your brief will be the platform for your business online. Hundreds, thousands or
hopefully hundreds of thousands of potential customers will see it. Therefore it behoves
you to take a little time out of your busy schedule to thoughtfully describe your brand,
your offerings, your market and your message. If you don’t do that then you are relying
on miracles as your strategy for success. From my experience, miracles are like buses -
there is never one in sight when you need it.
ii
The Website Development Brief
… a best practice guide to briefing web development agencies
iii
The Website Development Brief
… a best practice guide to briefing web development agencies
1. A WRITTEN BRIEF
Anecdotal evidence shows that the combination of a written and verbal briefing is the
ideal. There are enormous benefits to starting with a written document (produced by
you, the client), which is then analysed by the agency and inconsistencies discussed by
both parties at the subsequent verbal briefing. The process of developing, discussing and
agreeing the brief in this manner in itself adds value.
If you encounter an agency that says “we don’t need all that stuff” or gives the impression
that they haven’t studied your brief, then my best advice is to run in the other direction.
The industry has its fair share of so called ‘experts’ who think they know your business
and your customers better than you do. They will ignore everything you tell them.
Therein lies the source of the second major reason for failed web development projects
(the first being your failure to prepare an adequate brief).
A written brief is also vital to ensure the ‘buy-in’ of other key people in your company, in
enterprise support agencies, on your board and amongst investors, suppliers and other
business partners. This buy-in is essential to avoid the waste of time and resources that
can happen when others challenge the key assumptions during or after the project build,
leading to belated changes in direction. Ideally, your written brief should have the buy-
in of all interested parties before it is delivered to potential agency partners.
2. CLARITY OF THOUGHT
A good brief is not the longest or most detailed document. It’s the one whose clarity and
focus allows the agency to understand your customers, and what an effective solution
for them will entail.
“I didn't have time to write a short letter, so I wrote a long one instead.”
― Mark Twain
Briefs are called ‘briefs’ because they are meant to be brief! They are a summation of
your current thinking. Too much information can confuse the process. Relevance and
context are more important than reams of data. However, you should attach all relevant
supporting information as appendices.
Your brief should contain key nuggets of information and it should set out the objectives
of your product or service, which the website development project is to play a key role
in achieving.
This clarity and objectivity is not an attempt to reduce your creativity, or indeed that of
the agency. Emotive and dramatised descriptions of your company and the key issues it
faces make it memorable and can spark off great creative thinking and solutions you had
not considered. And it can challenge, inspire and excite those creative types in the
agency you hire.
iv
The Website Development Brief
… a best practice guide to briefing web development agencies
v
The Website Development Brief
… a best practice guide to briefing web development agencies
FINAL WORDS
Don’t forget… you need to consider the ‘words’ (known as copy) that will appear on your
website. Ideally this should be ready, or at least drafted, before you start building
anything. If you are writing it yourself or hiring another party to prepare it then get that
moving, or better yet completed, before starting work on the technology. To allow this to
happen you can look at other websites and prepare similarly sized ‘chunks’ of text that
the website developers can simply paste in.
Keep in mind that people don’t read long-winded websites nowadays; they consume
information in small chunks. So copy the approach of proven winners and don’t try
reinventing the wheel.
Something I personally do is look through website templates on themeforest.net and
decide on the one or two I like best. Then I prepare the words/copy and supply sample
images to suit my chosen templates.
I then go out looking for agencies that are prepared to use the themeforest.net template
because I know that will save us considerable time (don’t believe anyone who tells you
otherwise). That equates to saved money, which allows me to do more. Usually I will
insist on getting the template up and live with my copy and the images we chose
together as my first milestone. At that point I know I have a website that is, presumably,
bug-free and looks like it cost a fortune to design and build. Other things I want to
achieve with the website come later as subsequent delivery and payment milestones.
This ensures that I have something live and useful every step of the way, and that I can
test before we move on.
CONCLUSION
We have now discussed the key sections in a best practice project brief and why you
should write one. The key sections should be completed for every brief you write. The
detail within each section will vary according to your circumstances and your project
requirements.
Generally your brief should focus on defining ‘where we are now’ and ‘where we want
to be’. It is then the job of the agency to bridge the gap between the two. How they go
about that is their specialism, or it should be, and it should happen within the context of
your ‘what we are doing to get there’ description.
A crucial point is to be as explicit as possible about the measures of success, i.e. “how we
will know we’ve arrived”. And then there are the final operational details about project
management and practicalities. So enough talk, let’s get started…
vi
The Website Development Brief
… a best practice guide to briefing web development agencies
TEMPLATE
WEBSITE DEVELOPMENT
PROJECT BRIEF
The Website Development Brief
… a best practice guide to briefing web development agencies
CONTENTS
1. PROJECT CONTEXT 1
2. WEBSITE REQUIREMENTS 5
3. COMPANY OVERVIEW 7
4. SPECIAL FUNCTIONALITY 8
5. GRAPHIC DESIGN 10
6. WEBSITE ANALYTICS 12
7. WEBSITE ADMINISTRATION 14
8. ADDITIONAL DETAILS 16
The Website Development Brief
… a best practice guide to briefing web development agencies
1. Project Context
The Project Context (also know as Context, Setting or Prerequisites) is the
circumstances, facts or events that influence the project.
They explain the general idea and key prerequisites of the project, including
problems to be addressed, objectives, desired results, and parties interested in
and/or impacted by the project. It also describes the financial elements,
resources, timelines and other possibilities and limitations of the project.
The purpose of this section is to give an overview of the project, to provide initial
impressions about the project and to initiate the planning process. It does not
cover specific requirements, methods to be used or any other more detailed
information.
1
The Website Development Brief
… a best practice guide to briefing web development agencies
2
The Website Development Brief
… a best practice guide to briefing web development agencies
3
The Website Development Brief
… a best practice guide to briefing web development agencies
4
The Website Development Brief
… a best practice guide to briefing web development agencies
2. Website Requirements
This is a detailed explanation (also known as Project Needs or Project
Specifications) of what is needed or demanded from the project. In essence it is
where you want to be post-project.
This section is used to define the business needs, the problems to be addressed,
the implementation methods and approaches to be applied, and your desired goal
for the project. The goal should be set in the context of your overall business and
marketing plan, as well as what you believe will be achievable by this specific
project within your proposed timeframe and budget.
This definition of requirements is the most crucial part of the project. Incorrect,
inaccurate, or excessive definition of requirements may result in schedule delays,
wasted resources, or your dissatisfaction with the final outcome.
Every website is different but a single-minded and measurable objective is usually
a pre-requisite for success. Typical objectives are to increase sales by a factor of
‘x’, to increase usage by ‘y’, awareness, image, reputation, profitability, customer
profile, shareholder value, response levels, etc.
5
The Website Development Brief
… a best practice guide to briefing web development agencies
6
The Website Development Brief
… a best practice guide to briefing web development agencies
3. Company Overview
The Company Overview (also referred to as Product & Market) should contain the
following information, where relevant: product or service description (including
key attributes and benefits); manufacturing or service delivery; distribution
channels; market size (volume and value); customer usage data if available; your
company brand’s positioning; its history of brand communications, etc.
This section is used to define a more specific context for the project and to
determine the most suitable approaches and methods to be used.
Above all, remember that despite every website being different, they are all
intended to elicit some form of response from a particular group of people. Your
target groups should be clearly defined and prioritised as accurately as possible -
use demographics, lifestyle, product usage, attitudes, etc.
Equally and perhaps more important are the insights that you have about these
target groups. These insights can be used as a platform to build on and as a guide
for the various decisions that need to be made, in a way that will create the
desired reaction.
7
The Website Development Brief
… a best practice guide to briefing web development agencies
4. Special Functionality
The Special Functionality (or Additional Functionality) section of the brief is an
overview of specific features that you might wish to have on your website, and
that might increase the budget and time for the project.
It is used to plan and budget for features such as an online shop, customer portal,
member interaction, networking, etc.
Planning website functionally helps to see how your website can become more
than just a platform for promotion and selling. With time, it can become a tool to
build relationships with your customers and to improve your service delivery.
8
The Website Development Brief
… a best practice guide to briefing web development agencies
9
The Website Development Brief
… a best practice guide to briefing web development agencies
5. Graphic Design
Graphic Design (also known as Website Design or Visual Design) is the process of
arranging website content to enhance your visitor’s online experience, to transmit
your company values and to evoke or reinforce a desired emotional response.
It is used to optimize communication with your visitors, to organize information
in a cohesive and pleasing layout, and to improve the efficiency of content
presentation.
Website design encompasses information architecture, interaction, interface,
navigation, information and visual design. It is much more than colours and fonts.
10
The Website Development Brief
… a best practice guide to briefing web development agencies
11
The Website Development Brief
… a best practice guide to briefing web development agencies
6. Website Analytics
Website Analytics (also referred to as Google Analytics) is the functionally used
for measuring website traffic. It’s also useful for business research and market
research, and for determining and improving upon the effectiveness of your
website.
This section is used to define the requirements of the analytics functionality for
your website and to decide on the most appropriate vendor for those analytics.
12
The Website Development Brief
… a best practice guide to briefing web development agencies
13
The Website Development Brief
… a best practice guide to briefing web development agencies
7. Website Administration
This is the specific information needed by the provider to make changes to your
existing website or to make a new one live. They need this information to allow
them to import, export, upload, make changes and edit information in your
website databases, CMS and other systems.
Typically you will have one location where your domain name (the www address
or URL you will use) is hosted and a separate location where your website (the
pages, copy and images they agency will build) will be hosted. They may be at the
same place, but either way you will need to supply the login credentials to enable
the provider to do their job.
You might also have an account with someone like CloudFlare to enhance your
site’s performance and security, or an account with Google Analytics to monitor
and measure site statistics. Again, login credentials are essential.
14
The Website Development Brief
… a best practice guide to briefing web development agencies
15
The Website Development Brief
… a best practice guide to briefing web development agencies
8. Additional Details
The last section in any brief is where you document any further information that
might influence the project.
It enables you to supply complete project information and enhance the agency’s
understanding of the project.
Additional Details may take the form of brief comments, longer supporting
documents or any other information worth considering before starting the
project.
Additional Information?
If you have any additional documents that may be of use to the provider, please add them
here as appendices. Alternatively, mention each one and put them in an online/offline
folder you can share with the provider. This could include user manuals, functional
specifications, designs, or even memos and e-mails.
16