How to write a website specification document

how to write a website specification document

Functional Specification Document: What Is It and How To Create It?

May 13, †Ј How to Write a Website Specification. 1. Start by introducing yourself. Open with a short description of what your brand does. Just enough to provide a little background, without getting 2. Lay out your objectives. 3. Pull out your key audiences. 4. Your competition. 5. Website structure (donТt. Jun 02, †Ј Find out how to write effective website functional specifications that get all team members on the same page before development starts. Subscribe to our blog One of the main responsibilities of the functional analyst is to provide a clear and detailed description of the different functional parts of a website and their required behavior.

One of the main responsibilities of the functional analyst is to provide a clear and detailed description of the different functional parts of a website and their required behavior.

These descriptions of what the website will do are also called functional specifications. Examples of the latter are templates used to create different types of web pages e.

Functional specifications are also important tools which are used by the different web teams:. A good specifications document has to match the needs of the different teams involved in the website project. But what do you have to take into account how to prioritise your workload cover so many aspects of design, functionality, development and user experience? The following 10 tips will get you started.

It is essential to understand that the creation of specifications is not an individual task. It is the result of a collaboration between the client, the functional analyst, UX, design and the technical teams. Therefore, specifications are preferably created in a collaborative environment e.

This makes it possible for all team members to work together in an easy way, even if they operate from geographically remote locations. The functional analyst can be considered as the specification master, who makes sure that all inputs are documented in a consistent way.

Functional specifications need to be identifiable. This can be done by defining a clear and unique name for the functionality it describes. This seems to be a trivial step, but experience tells this is an important one. This name is important because it will be used during the whole lifecycle of the web project. It will be used in conversations with all stakeholders, in code, technical documentation, user documentation and training.

So think twice before setting the name. Also provide a unique numeric ID, next to the more descriptive title. Specifications need to be structured to make it easy to use them. During conversations it should be easy to consult them and retrieve the required information quickly. Seemingly simple things can help you accomplish this:. People prefer watching over reading. They also tend to understand things better when they see it. Adding visual elements to your specification document will help the different teams involved to understand the described functionality more quickly.

This can be done by adding wireframes, flow charts, prototypes, design screenshots, and so on. Whenever you can, add clear references to additional relevant resources within the project. When the different teams start using the specifications documents, it should be easy for them to locate related sources of information, such as design files, coding style guides, design specifications, prototypes or what size bedding for a daybed related functional specifications for e.

Functional specifications documents are, as already mentioned, used by a lot of different roles. They are used as an instrument to discuss as well as to inform all the teams what are the disadvantages of radiotherapy all the features, interactions and every detail of functional behaviour that has to be how to attach a web link to an email. Therefore, they should be written in a non-technical way that is clearly understandable by all stakeholders, be they technically minded or not.

An initial specification is created for each functional component at the start of a web project. This means the functional behavior might be revised. Specifications need to be clear and precise. In the ideal world, developers should not be left to guess or have to interpret the functional descriptions.

This can be done by using clear language, providing examples if required, and having all their questions answered about what needs to be achieved, how and why. During the functional discussions between the web team members and the client a lot of decisions are made. Make sure to keep track of all the decisions related to functionality and that these are reflected in the final functional specifications document approved by the client.

While new functionality can still be introduced mid-project, this will be useful to avoid discussions in the future. Make it digestible. When creating written specifications it is important to avoid an information overload.

One way to do it is to identify the individual functional parts of a website and create separate specifications for each one of them. On one hand, it keeps information focused for the reader, and on the other hand, it matches to the way tasks are usually organized in Agile stories, which makes it easy to integrate with project tracking software like JIRA.

It seems crystal clear that the functional specification document is critical to ensure the design and development teams working on the project are on the same page as the client, and ultimately, to guarantee everyone will be happy with the finished product. Effective website specifications provide a clear roadmap and targets for the web team to aim for, and help avoid unnecessary deviations from the plan, not only in terms of time, but also in terms of cost.

Are you looking for a new website for your business, an upgrade to your digital marketing platform or an ecommerce solution? You have come to the right place. Web DevelopmentDigital Strategy.

Specializing in functional analysis and web development, Joris has been part of the Amplexor Digital Experience team since Amplexor Blog Digital Experience 10 tips to write killer website functional specifications. Would you trust a builder to start building your house without any plans?

The same idea goes for website projects Ч skipping preparations comes with risks. Find out how to write effective website functional specifications that get all team members on the same page before development starts. Subscribe to our blog. Functional specifications are also important tools which are used by the different web teams: The client can use them to check if the functionality that will be developed matches their needs and to suggest optimizations before the implementation process starts.

The project manager will be what does romanichal gypsy mean to assign resources to tasks and trace a reasonably accurate timeline for the project.

The technical lead uses the functional specifications as the starting point to define the technical specifications for the development. The WCMS developers combine the functional and technical specifications as direct what does the butterfly rash of lupus look like to start development work. The testers use them as the foundation to establish guidelines on what to test for each functionality as well as to document and create detailed test scenarios.

Make what time does kohls close on black friday 2013 collaborative It is essential to understand that the creation of specifications is not an individual task. Make it uniquely identifiable Functional specifications need to be identifiable. Make it structured Specifications need to be structured to make it easy to use them. Seemingly simple things can help you accomplish this: Create a template to make sure that all the functional specification documents for functional components are structured in the same way.

Use a table instead of running text to detail the individual specifications for each component Standardize and structure the wording of individual functional specifications in the same way, e.

Make it visual People prefer watching over reading. Make it integrated Whenever you can, add clear references to additional relevant resources within the project. Make it readable Functional specifications documents are, as already mentioned, used by a lot of different roles. Make it extendable An initial specification is created for each functional component at the start of a web project. Make it precise Specifications need to be clear and precise.

Make it traceable During the functional discussions between the web team members and the client a lot of decisions are made. Make it digestible When creating written specifications it is important to avoid an information overload. Conclusion It seems crystal clear that the functional specification document is critical to ensure the design and development teams working on the project are on the same page as the client, and ultimately, to guarantee everyone will be happy with the finished product.

Joris Bekaert. You may also be interested in reading. Why your website accessibility matters and who is affected 15 April The top 5 elements of user experience and how they help your website 09 April Want to learn more about Amplexor and our industry-leading solutions? Drop us a line! Contact Us. All rights reserved. Legal Privacy Policy.

2. Is it completely new project or it is redesign/reprogramming of existing one?

Feb 20, †Ј Writing a functional specification. Now that you know what a functional specification is and why itТs a good idea to write it, here are a few tips to help you get started. A specification is a text document that identifies stakeholders, its own history and potential previous approvals. Apart from that, a functional specification needs to include: Project scope Ц the goals, deliverables, features, tasks, . Jul 06, †Ј Write in clear language. For the most part, your functional specification document is going to be written in non-convoluted language. The reason for this is because itТs easier to discuss features and design the solutions of a product in plain language Ц and revise those ideas Ц .

Every website project should start with a specification. E-commerce projects come in all shapes and sizes, with every feature and design element offering new complexities. When you approach agencies, you need to be armed with a killer specification. Open with a short description of what your brand does.

Just enough to provide a little background, without getting into the weeds. Get at least one goal for the project, written down. These are likely to be:. For instance, one segment might head to your website to keep on top of your blog posts. Whether you want them to buy a product or get in touch about careers, this should align with the objectives you set in section 2.

Who has the best online store and why? Oh, and this part is also handy in helping your agency partner understand your industry that little bit better. It tends to change around the design stage. A change could yield benefits and prevent carrying old assumptions into a new project.

You should list out any functional requirements for your home, product listing, search, and product detail pages. These describe what different users should be able to do whilst on your online store, and look a bit like this:.

At this stage, you should also detail any technical preferences you may have. Or other aspects that just Budget of course. Now and again, brands shy away from disclosing their budgets when they first approach agencies. Being transparent about what there is to play with, means agencies can come up with the best solution to match.

A good agency will think about what can be done with it, whether that means discussing a phased approach or recommending you different technology. We beg you: be reasonable! E-commerce website projects can take anywhere between 6 weeks and 6 months. It all depends on the size of the project. If you have nothing live currently, things like sign-up pages can actually be a good way to gather email addresses and build excitement before you launch your new website.

And if you need a quick turnaround, there might be the option of launching with an MVP site, whilst the full bells and whistles version is in the works. Your data is stored securely and we never pass it on to third parties.

How to Write a Website Specification. Strategy May 13, by Alex O'Byrne 7 minute read. Start by introducing yourself Open with a short description of what your brand does. Brief history Size number of employees, turnover Key services Major achievements Your mission statement 2. Lay out your objectives Explaining these will drive the rest of the specification. Think about: Why you need the project? What outcomes do you want to achieve Ч are they measurable? Are there problems with your existing site?

What are the business drivers for the change? Got them listed? Now, for each group, consider: What do they want to do on your website? What do you want them to do on your website? The meaty part: functional specification In other words, what should the website do?

Usability : do you have accessibility requirements? If you plan to sell in the US, have a read of this. Could your website be used mainly on tablets? Perhaps by the elderly? Security : do you need to be PCI compliant? Website performance : how important are loading times to you? Legal : are there any industry-specific compliance requirements your website must adhere to?

The good, the bad, and the ugly What about those that have caught your eye in a good way? The B word Budget of course. What have you got to lose? Outline your procurement process When sending your website specification to agencies, be clear on this stuff.

When do you need a response by? Who will be the main point of contact at your brand? Who are the stakeholders? When will a decision be made by? Any other key dates to include? Get a fresh pair of eyes on it to help spot any fluff. You want to prevent miscommunication and not have to explain things verbally. With that said, good luck and go forth! Popular Articles. Straight to your inbox.

2 thoughts on “How to write a website specification document

Add a comment

Your email will not be published. Required fields are marked *