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

1
vote
2answers
353 views

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

What is the process of planning software called? 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 ...
6
votes
5answers
484 views

What to call requirements that are “assumed”/“invisible”/“very obvious”

I'm looking for an umbrella term for all the nitty-gritty requirements that it's helpful to have specified up front but which the client never thinks about in his excitement about the product. In the ...
7
votes
2answers
27k views

What Specifications should a Programmer Seek in a Computer Purchase ? Or, What Computer should I buy? [closed]

I wish to acquire a new computer that is specially designed for programming. I would like to build it myself for the learning experience, but am willing to purchase it made as well. Basically I ...
-1
votes
1answer
18 views

How to help you client into making better requirements for you? [duplicate]

One of the most difficult and critical part of a project is to get good requirements from your client (internal or otherwise). I understand by 'good requirement' one that is not so high-level that's ...
7
votes
4answers
486 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.
0
votes
0answers
20 views

Including a third party (database) API in a generic spec

I am developing the specification for a platform on top of which (relatively simple) applications should be developed. Those applications require access to storage (nothing fancy), but the problem I ...
0
votes
1answer
30 views

What are messages in FHIR?

I am trying to get my head around Fast Healthcare Interoperability Resources (FHIR) specification, but I can't understand what Messages are used for. The exact mechanism of transfer is ...
1
vote
1answer
107 views

How can I find what Resources a Java EE container provides?

How can I find what "Resources" a Java EE container provides? Can I discover this programmatically, or is there documentation I should refer to? (Note that the Java EE tutorial is vague on this ...
5
votes
2answers
32k views

What is the difference between technical specifications and design documents?

What are technical specifications? Are they the same as design documents. If not, what is the difference and some examples?
2
votes
1answer
121 views

How do I write a REStful API's functional specifications?

I've been looking for answers about writing functional specifications for a software for a while now but I can't seem to find an answer to my specific case. I think I understand the difference ...
61
votes
5answers
46k views

Two HTML elements with same id attribute: How bad is it really?

Just browsing the google maps source code. In their header, they have 2 divs with id="search" one contains the other, and also has jstrack="1" attribute. There is a form separating them like so: ...
1
vote
1answer
121 views

How do tools facilitate writing functional specifications?

C2 wiki on functional specifications suggest that this can be facilitated by tools, how? A Functional Specification is a list of demands and constraints intended to describe a product to be ...
0
votes
0answers
57 views

How to deal with requests that don't conform to the existing data structure?

The system I'm working on has a list of assets that belong to different customers of the company. This data is saved on an SQL database. Removing irrelevant data, let's say the table is like this: ...
3
votes
2answers
184 views

How to deal with historic exception specifications in maintained C++ code

Today, I discovered a few exception specifications in legacy code I've to maintain, when Cppcheck 1.68 ([Inconclusive] but correctly) pointed out that the specified exceptions are not handled in ...
1
vote
2answers
118 views

What is meant by “redundant, but not duplicative” in the Steelman language requirements?

The Steelman language requirements have this: The language shall require some redundant, but not duplicative, specifications in programs. I think I can see the underlying idea (that re-stating ...
0
votes
2answers
337 views

Where is it specified that Java is call by value?

I know that Java is by default call-by-value but I am not sure where in the Java Language Specification this is addressed. Google searching only seems to find me unofficial sources but never points to ...
2
votes
2answers
856 views

Project implementation details in node.js

I am working as a software engineer turned team leader in a large software company. One of my areas of strength is node.js, and we are in the process of moving a lot of our services to separate ...
0
votes
2answers
146 views

The source is the documentation - part 1 [closed]

Searching the specification for the btrfs file system i stumbled once more over the catchphrase: "The code is the documentation". This implies that changing the code changes the specification. Does ...
0
votes
3answers
132 views

Seeking advice writing functional requirements [duplicate]

I inherited a project that I've been maintaining for approximately a year now. The project primarily revolves around performing various financial calculations for the end user. It's roughly 100,000 ...
1
vote
2answers
98 views

In a specification, should I describe what a product does (ideally) or what it should/must do?

I'm writting a German specification (I'm not German). Differences may appear for this process in different cultures, especially in the terminology, but usually here's the idea: The client writes ...
2
votes
5answers
268 views

Why doesn't the HTML\DOM specification allow hyperlinks to set an accept header?

The purpose of the Accept header from the client is to tell the server what kind of data it will accept as a response to its request. We can set this header in asynchronous HTTP calls in Javascript, ...
4
votes
4answers
251 views

How big can the binary code be?

Where does binary go in a computer? When you turn the computer on it points to the bios and runs through it. I get that. Then it loads data off something ( disk, flash, etc. ). But where does it go? ...
0
votes
0answers
88 views

Appropriate design / technologies to handle dynamic string formatting?

recently I was tasked with implementing a way of adding support for versioning of hardware packet specifications to one of our libraries. First a bit of information about the project. We have a ...
2
votes
2answers
139 views

Specification languages vs automated tests

I recently listened to an episode of Software Engineering Radio in which Leslie Lamport was interviewed. One thing he discussed was his specification language, TLA+. Essentially, he seemed to be ...
-1
votes
1answer
77 views

What specifications in software development are relevant to the clients? [closed]

Say your company develops software, and a client wants you to handle their development. It just so happens, that they have their own IT-team, but it is fully tied up, so they outsource to you. The ...
0
votes
1answer
84 views

RFC syntax definition [closed]

I would like to bring our specifications to a better level of fine-grained definition of syntaxes, semantics and the like. I read my fair share of RFCs and just love the way they define things like ...
89
votes
12answers
52k views

What is the difference between requirements and specifications?

I've been tasked with developing requirements and specifications for a project our group is starting. I realized that I don't know the difference; a Google search just confused me more -- it seems ...
8
votes
2answers
16k views

What are the differences between throwaway and evolutionary prototypes?

I have notes about various methods of prototyping, and I found several definitions on the Internet, but I would like to confirm what I learned. I understand that throwaway prototyping is developed ...
0
votes
1answer
111 views

Documentation required for commissioned software (product) [closed]

The company I work for has commissioned a software company to produce a compliance software for several big companies. As part of our contract it is required of them to provide us with src code and ...
0
votes
1answer
65 views

What is the appropriate Data URI to use for 0-byte content?

I have a method that generates a data URI from a byte array. In the event the input byte array is empty, what is the appropriate thing for the method to do? Here are the options I see: return data:, ...
6
votes
2answers
206 views

How to put lessons learned, good practices, etc into the “work flow”

As the title states it, I would like to get some suggestions about putting knowledge into action. We have many additional requirements that concern: coding practices feature development (all of them ...
0
votes
1answer
111 views

SQL-99 specification, is it specified to first order the result and limit it afterwards?

If I wrote this in MySQL SELECT * FROM foo ORDER BY bar LIMIT 1 it would first order the result and limit it afterwards. I always get the lowest bar. I wonder if this is specified like this in ...
12
votes
2answers
624 views

“Do it right, against customer's wishes” - how is it called? [closed]

We know the optimal situation of negotiating corrections of specifications with the customer, getting the specs to do what the client wanted, not what they said or thought they wanted. That's ...
0
votes
2answers
332 views

Before you develop a web app, how much of a spec do you need? [closed]

If you were to accept a role as a full time web app developer responsible for creating a new application from scratch, how much of a defined specification and design would need and/or expect to start ...
1
vote
0answers
74 views

What types of specification documents exist in app lifecycle?

Developers in large companies usually have multiple specification documents that they write at each phase of the software in question. I've heard of some of them and would like someone to tell me of ...
17
votes
2answers
859 views

How up-to-date is the Joel test? [closed]

I want to convince my partners that we should have a spec and that bugs should get fixed before writing new code. Should I refer to the Joel test? Do you think that the Joel test is up to date? I ...
12
votes
5answers
3k views

What grammatical tense should I write my specifications in?

We are currently writing functional and technical specifications in a two column format; summary sentence and technical detail. The details often refer to an appendix with diagrams, layout designs ...
11
votes
5answers
595 views

What should I do if I don't have any formal spec? [duplicate]

I recently was assigned to a task, but it says only a couple of words, like, do it as it made there, with no actual spec attached. What is the best thing to do in that circumstances?
28
votes
1answer
940 views

If the spec is flawed, should it still be followed?

I have been assigned to develop an integration to one of my employer's applications to an external system developed by our client. Our client's specification for the integration that has some blatant ...
1
vote
1answer
198 views

“A line comment acts like a newline”

I'm reading the Go language specification. The section on comments states: Line comments start with the character sequence // and stop at the end of the line. A line comment acts like a newline. ...
0
votes
1answer
22k views

Difference between functional and technical specification [duplicate]

I'm writing a specification for a project, and am struggling with separating functional specification from technical specification (see http://www.joelonsoftware.com/articles/fog0000000035.html). ...
2
votes
5answers
672 views

bug: deviation from requirements vs deviation from expectations

I am not clear on this one. No matter the terminology, in the end the software fault/bug causes (according to a lot of sources): Deviation from requirements Devation from expectations But if ...
12
votes
8answers
574 views

How do you make a manager understand Agile?

I have a problem with a senior director who doesn't understand iterative development (much less Agile). He is insistent that our software design specification (SDS) be complete before any line of code ...
2
votes
2answers
12k views

System requirement specification vs functional one - separate docs? [duplicate]

A lot of sources (e.g. Wikipedia) mentiones System requirement specification and Functional specification as two separate entities. However, Wiegers in his book writes: The software requirements ...
4
votes
3answers
289 views

Customer Requirements Contains Equations that Cancel to Nothing

I have a project where the customer requirement specifies a report and contains mathematical equations for the contents of some of the columns on that report. One of the columns on this report is a ...
1
vote
2answers
373 views

Formalizing a requirements spec written in narrative English

I have a fairly technical functionality requirements spec, expressed in English prose, produced by my project manager. It is structured as a collection of UI tabs, where the requirements for each tab ...
0
votes
2answers
552 views

Software Requirement Specification documentation by professionals

I just wanted to know what is the significance of SRS(Software Requirement Specification) in programming? and what are the techniques used in preparation of an SRS .. also who writes the SRS.. is it ...
4
votes
7answers
1k views

What do you call a customer's customer in a specification document, use case, or scenario?

My team and I develop software that our customers will use to interact with their customers. Additionally, we also eat our own dogfood and use the software ourselves to interact with our customers. ...
15
votes
6answers
1k views

Can you claim that your product is fit for purpose when it uses OSS software which does not guarantee it?

I am working on a product for a client that must be valid and fit for purpose. It's built on a LAMP stack (PHP/Cake), so there's GPL, MIT, PHP, APACHE licenses: "AS IS" BASIS, WITHOUT WARRANTIES ...
9
votes
1answer
160 views

How to avoid duplication between my issue tracker and the project specification documents?

I used to work for a professional consulting firm, and we worked under many different contract terms. When we could get a time & materials project, we ran it with SCRUM and tracked the backlog in ...