A specification (often abbreviated as spec) is an explicit set of requirements to be satisfied by a material, product, or service.

learn more… | top users | synonyms

0
votes
1answer
73 views

Is there such a thing as a specification-code framework?

I've been googling for a while and can't fathom why this doesn't exist yet. By a specification-code workflow I mean a system which links code to it's specification. For example I could be looking at ...
4
votes
2answers
2k views

Custom HTML Tags: Are there any specifications stating a standard way to handle them?

It seems like for years they've just been given default styling and inline display. Is there a spec somewhere that has dictated this? I've looked over the RFC's but I'm not particularly good with ...
4
votes
1answer
183 views

General solution to solve different sports results in different languages

I currently have some code that checks if squash and tennis scores are valid, both in javascript and PHP. This results in 4 blocks of code existing, 2 languages * 2 sports, which does not scale well ...
2
votes
2answers
314 views

What is the process of planning software called? Or what is the job title of someone who does software planning?

For example, let's say a non-technical person comes to me with their rough initial specification. And I sit down with them over a couple weeks and help them hone, formalize and better plan the ...
15
votes
9answers
1k views

How to convince a non-technical client that their application spec needs to be simplified?

Often times I am faced with the situation where a new client comes to me with an application that has literally 100s of unnecessary features and it is quite clear that things need to be drastically ...
25
votes
1answer
5k views

Java: “Heap pollution”

A "Heap Pollution" as in Non-Reifiable Types (The Java™ Tutorials > Learning the Java Language > Generics (Updated)) Why is it called that way?
-3
votes
3answers
426 views

Does *every* project benefit from written specifications? [closed]

I know this is holy war territory, so please read the question to the end before answering. There are many cases where written specifications make a lot of sense. For example, if you're a contractor ...
2
votes
2answers
371 views

Estimating time for planning and technical design using Evidence Based Scheduling

I'm at the beginning of a development project in a large organization. The Functional Requirements are currently being worked out and documented with our business stakeholders by our Enterprise ...
20
votes
7answers
1k views

How can a non-technical person learn to write a spec for small projects?

How can a non-technical person learn to write specs for small projects? A friend of mine is trying to outsource some development on a statistics project. In particular, he does a lot of work in ...
1
vote
1answer
1k views

ISTQB terminology question (Defect)

According to ISTQB (and few more sources + wiki ), a defect/bug is the actual cause of error in software, e.g. incorrect statement, logical or semantic error. The actual definion is: a flaw in the ...
0
votes
3answers
105 views

What do you need from a client to create a site

I am trying to figure out what a programmers needs from a client to create a website. This is a complicated database driven site. How should the information look? Should I layout the pages in ...
41
votes
4answers
5k views

Experience of Python's “PEP-302 New Import Hooks”

I'm one of the developers of Ruby (CRuby). We are working on Ruby 2.0 release (planned to release 2012/Feb). Python has "PEP302: New Import Hooks" (2003): This PEP proposes to add a new set of ...
5
votes
3answers
966 views

How To Document an Object Oriented Design in Text

For my next project, I'm looking to document my Object Oriented design in simple text before jumping the gun to code it up. I want to do this for two reasons. I want to give proper thought to my ...
2
votes
1answer
104 views

When to skip solving the general problem and settling for the specific problem?

I've been working hard on trying to develop a general solution to my problem, but I cannot seem to formulate a proper algorithm for it, at least one that doesn't take a ton of inaccurate grunt work ...
2
votes
1answer
156 views

Should I provide a language reference in addition to a formal specification for the programming language I am designing?

I am designing a programming language, and I would like to provide a complete documentation for it. So far, I have planned to write the following documents: An initial design outline, mostly as a ...
9
votes
5answers
356 views

Spec Writing Management

I simply cannot imagine writing software without a spec. No matter how sketchy or high level it is, spec is important to explain to the clueless programmers on what are the functionalities of the ...
2
votes
0answers
60 views

New website - best practice for requirements specs? [duplicate]

Possible Duplicate: Extracting user requirements from a person who does not know how to express himself As a hobby freelancer I'm new to this. I've never had a non-technical client before ...
3
votes
4answers
831 views

Who should be responsible for writing/updating design specifications in an agile team

I work as part of a scrum-like Agile team and a while ago, one thing we identified that the team should do is maintain good set of design documents for our code base. Because we are agile and do have ...
9
votes
6answers
582 views

Should we put the specification documents in source control system such as svn?

Today, One of my colleague and I have a debate about "Should we put the specification documents in source control system such as SVN?". In my opinion, It should be. Everything relate to developing ...
4
votes
1answer
258 views

What is an effective way to organize tasks for a new project?

Is there a practical solution to organizing the initial tasks for a new project? To elaborate, imagine the features/stories/goals are laid out for a project. How might one go about organizing those ...
4
votes
1answer
67 views

Tooling and support for message format specifications

How do most companies define and manage message format specifications? Is it common for companies to create custom tools for creating and working with these documents? At work we have a lot of ...
0
votes
3answers
546 views

How to write Requirements for a specific module

I am familiar with writing Software Requirements Specification, but not quite sure how to write the requirements for a specific module. Let's say I need to develop a Reservation System and there ...
6
votes
4answers
346 views

I want to explain why the specification must not be changed during development period

I want to explain why the specification must not be changed during development period to the new planning department employee. Is there any cool document that does this?
5
votes
4answers
229 views

Concurrent development w/o central design?

I've got a team of developers which are trying to write specifications/tests concurrently for different (and sometimes adjacent) parts of the system. Typically, the person writing the ...
0
votes
0answers
395 views

Are there any good resources to learn how to write tech specs/design documents [duplicate]

Possible Duplicate: Writing a Software Requirement Specification How to make a great functional specification I am starting to write more tech specs and design documents. However, I don't ...
17
votes
9answers
1k views

How do I move a client from UI mockups to a set of real requirements?

Say you are given a mock-up of 25 screens of the visual states of your application. The expectation is that this is enough for us to be confident we can develop and hand it to the original stakeholder ...
5
votes
5answers
789 views

Interesting questions about Behaviour-Driven Development

For my master thesis at Software Engineering, I want to investigate in the new development technique BDD (Behaviour-Driven Development). In my opinion this technique could really improve on customer ...
8
votes
6answers
205 views

How do you create a software process for a project?

As I've written about in other questions here, the project that I'm working on now has no software process. That means no documentation (including hard copy requirements or specification), no source ...
0
votes
3answers
850 views

How do I write a specification? [duplicate]

Possible Duplicate: how do I write a functional specification quickly and efficiently With so many projects changing halfway - and clients assuming much can be changed at no additional cost ...
5
votes
5answers
203 views

The value of an updated specification

I'm at the tail end of a large project (around 5 months of my time, > 60,000 lines of code) on which I was the only developer. The specification documents for the project were designed well early on, ...
5
votes
5answers
287 views

Managing software projects - advice needed

I work for a large government department as part of an IT team that manages and develops websites as well as stand alone web applications. We’re running in to problems somewhere in the SDLC that ...
5
votes
3answers
976 views

Are there standard practices when writing a spec for a software development project?

Are there standard practices when writing a spec for a software development project? Is there a specific format to follow? Also, does the developer or the client write this up? If the dev, is this ...
6
votes
4answers
352 views

Why it is important to include definition of success/failure in specification?

I've read Steve McConnell's "Code Complete" and one of items in checklist for requirements is: "Is the definition of success included? Of failure?". Why is this important? Can you write any examples ...
26
votes
3answers
7k views

Why are exception specifications bad?

Back in school some 10+ years ago, they were teaching you to use exception specifiers. Since my background is as one of them Torvaldish C programmers who stubbornly avoids C++ unless forced to, I only ...
5
votes
3answers
508 views

How can we verify that software meets specifications meets requirements?

So we're pretty good at eliciting requirements from our end customers, business division and sales/marketing. We plan projects to add/enhance features to meet those requests and prioritize tasks to ...
4
votes
2answers
9k views

Where can I find examples of functional specifications? [closed]

I am writing a functional specification for a software program (Mac OS X application to be exact). I want to improve this by looking at other (good) functional specifications, but I cannot find any. ...
8
votes
13answers
694 views

Can you write an unambiguous specification in a natural language like English?

It seems to me that you cannot possibly write a software specification in English that is completely free of ambiguities, simply due to the informal nature of natural language - and therefore that a ...
1
vote
4answers
337 views

What standards does your team use for your specification documents headers and footers?

TL;DR: What header/footer do you put on your Functional&Technical specifications to avoid people having different versions at meetings? Story: We're have a lot of documents, being changed by ...
8
votes
6answers
598 views

When should development stop and QA begin?

We write a complete functional specification for our development team of two. We do not have professional testers however we have drafted in the help of our available helpdesk personnel to perform 'QA ...
2
votes
5answers
110 views

Should an XML Schema be specified in a software specification?

Would you include an XML schema for a new file format in a software specification document or would you consider this too specific? Or would it be already too specific to require XML at this point?
1
vote
4answers
750 views

How do you spec out your project?

all. I'm wondering how do you spec./plan out your project? For example, for webiste you can use Wireframe. How about for desktop or add-ins such as MS Office add-ins? I want it as simple as possible ...
16
votes
8answers
411 views

Let users get requirements together on their own or guide them along?

I'm sure everyone has experienced something like this. You go into a meeting with a client who has a project. They have no/few requirements in mind and the vaguest understanding of what they ...
4
votes
1answer
122 views

Have you ever dealt with writing a spec late in the development lifecycle?

We have an existing code base which has been developed to meet the needs of most of our clients, which has accumulated features and bug fixes as they were needed and as projects developed universally ...
11
votes
5answers
4k views

What to plan before starting development on a project?

Say I've received the specs for a project from a client, and now its time to start developing it. Normally, I just start with the first module (usually user registration) and then go from one module ...
2
votes
3answers
240 views

Is it practical to retroactively write specifications documenting a system via automated acceptance tests?

If a project was coded without much (or any) formal documentation and is without unit tests, does it make any sense to use tools like Fitnesse and SpecFlow to write automated acceptance tests as the ...
2
votes
3answers
293 views

What techniques should be used to ensure clear communication from the customer?

Some customers use terms from the domain language interchangably and incorrectly. This has, on several occassions, lead to an implementation of a feature in a way that was not desired by the customer. ...
7
votes
9answers
627 views

Why bother with detailed specs?

When writing software, what's the point of writing a formal, detailed dead-tree specification? To clarify, a somewhat informal, high-level specification for people who don't want to read the code ...
1
vote
2answers
57 views

Specifying and applying broad changes to a program

How do you handle incomplete feature requests, when the ones asking for the feature cannot possibly write a complete request? Consider an imaginary situation. You are a tech lead working on a piece ...
5
votes
5answers
3k views

How to make a great functional specification

I am going to start a little side project very soon, but this time i want to do not just the little UML domain model and case diagrams i often do before programming, i thought about making a full ...
2
votes
1answer
229 views

Where can I learn and understand the complete workings of HTTP headers, so I can implement my own? [closed]

I am looking to learn how to properly use, and implement, HTTP headers. What is the best resource or set of guidelines that I can use? ( especially ranges to detect download managers, etc) ?