Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

How to write a spec for a website

As I'm starting to develop for the web, I'm noticing that having a document between the client and myself that clearly lays out what they want would be very helpful for both parties. After reading some of Joel's advice, doing anything without a spec is a headache, unless of course your billing hourly ;)

  1. In those that have had experience, what is a good way to extract all the information possible from the client about what they want their website to do and how it looks? Good ways to avoid feature creep?

  2. What web specific requirements should I be aware of? (graphic design perhaps)

  3. What do you use to write your specs in?

  4. Any thing else one should know?

Thanks!

Ps: to "StackOverflow Purists" , if my question sucks, i'm open to feed back on how to improve it rather than votes down and "your question sucks" comments

like image 301
SeanDowney Avatar asked May 21 '09 18:05

SeanDowney


2 Answers

Depends on the goal of the web-site. If it is a site to market a new product being released by the client, it is easier to narrow down the spec, if it's a general site, then it's a lot of back and forth.

Outline the following:

  • What is the goal of the site / re-design.
  • What is the expected raise in customer base?
  • What is the customer retainment goal?
  • What is the target demographic?
  • Outline from the start all the interactive elements - flash / movies / games.
  • Outline the IA, sit down with the client and outline all the sections they want. Think up of how to organize it and bring it back to them.
  • Get all changes in writing.
  • Do all spec preparation before starting development to avoid last minute changes.

Some general pointers

  • Be polite, but don't be too easy-going. If the client is asking for something impossible, let them know that in a polite way. Don't say YOU can't do it, say it is not possible to accomplish that in the allotted time and budget.
  • Avoid making comparisons between your ideas and big name company websites. Don't say your search function will be like Google, because you set a certain kind of standard for your program that the user is used to.
  • Follow standards in whatever area of work you are. This will make sure that the code is not only easy to maintain later but also avoid the chances of bugs.
  • Stress accessibility to yourself and the client, it is a big a thing.

More stuff:

  • Do not be afraid to voice your opinion. Of course, the client has the money and the decision at hand whether to work with you - so be polite. But don't be a push-over, you have been in the industry and you know how it works, so let them know what will work and what won't.
  • If the client stumbles on your technical explanations, don't assume they are stupid, they are just in another industry.
  • Steer the client away from cliches and buzz words. Avoid throwing words like 'ajax' and 'web 2.0' around, unless you have the exact functionality in mind.
  • Make sure to plan everything before you start work as I have said above. If the site is interactive, you have to make sure everything meshes together. When the site is thought up piece by piece, trust me it is noticeable.
like image 126
Dmitri Farkov Avatar answered Oct 15 '22 09:10

Dmitri Farkov


One piece of advice that I've seen in many software design situations (not just web site design) relates to user expectations. Some people manage them well by giving the user something to see, while making sure that the user doesn't believe that the thing they're seeing can actually work.

Paper prototyping can help a lot for this type of situation: http://en.wikipedia.org/wiki/Paper_prototyping

like image 28
John Fisher Avatar answered Oct 15 '22 09:10

John Fisher