Software Engineering Stack Exchange
Software Engineering Stack Exchange

Questions tagged [standardization]

The process of altering or creating code to an agreed standard or the process of establishing that standard.

While in general standardization simply means moving towards a standard in terms of programming this is simply simply the process of altering or creating code to an already agreed standard (often with the express aim of interoperability or code reuse) or the process of obtaining consensus and establishing that standard.

32 questions
150
votes
17 answers

Coding standard for clarity: comment every line of code?

I've worked in shops that produce life critical software and I've dealt with commenting rules that were meant to keep the code readable and potentially save lives. In my experience though the requirement becomes a brain dead chore to be ticked off…
candied_orange
  • 102,279
  • 24
  • 197
  • 315
55
votes
7 answers

Why do so many standards for JSON API response formats contain a "success" property in the response body instead of just using HTTP status codes?

I was researching about best practices for standardised JSON response formats for APIs, according to various sources available online general consensus looks something like this: //Successful request: { "success": true, "data": { /*…
Šime
  • 669
  • 1
  • 3
  • 6
28
votes
11 answers

Why are there so many competing filesystem designs?

Just a quick question, but why are there so many file systems still competing and in use today? (ntfs, fat32, ext3(ffs), etc) It seems that file system designers could agree upon the best aspects of each type of system and implement a "best"…
Dark Templar
  • 6,223
  • 16
  • 46
  • 46
27
votes
8 answers

Deprecation considered harmful?

I've just been compiling some of my own code with the -std=c++0x flag in GCC, as I want to vaguely keep up with what all the young folks are doing (provided they stay of my lawn), and I ended up with a load of warnings about auto_ptr being…
Neil Butterworth
  • 4,056
  • 3
  • 23
  • 28
27
votes
6 answers

Creating a coding standards document

I work in a control systems company, where the primary work is SCADA and PLC, along with other control systems stuff. Software development is not really something the company does, apart from little bits here and there, until there was a decision to…
Felix Weir
  • 502
  • 1
  • 6
  • 12
21
votes
5 answers

How do I go about writing a programming language specification?

I really enjoy programming language design. Sometimes I think my language projects and their potential users would benefit from a comprehensive standards document. I've looked at many language standards, ranging from the very formal (C++) to the…
Jon Purdy
  • 20,437
  • 7
  • 63
  • 95
18
votes
1 answer

Is Open Data Protocol (odata) Being Widely Embraced by the Development Community?

EDIT: In case you aren't familiar with OData, here you go. I am trying to determine whether it is worth learning this technology or if it is something that is not going to catch on. The premise is interesting, and as a developer of APIs it seems…
Matt Cashatt
  • 3,315
  • 5
  • 24
  • 35
16
votes
4 answers

Is validating HTML a thing of the past?

With us moving continually closer to HTML5 in terms of adoption, is writing HTML for validity something the web is rejecting, allowing us to straddle standards as the web continues to be in a perpetual state of transition to the "next" thing? Is…
jondavidjohn
  • 843
  • 1
  • 6
  • 14
12
votes
3 answers

Defining a standard

How would you go about defining a standard? I am defining a protocol for a sort of thing that does not exist yet and I would like to create an RFC for it, and use a well-known port number provided by IANA. How do I start?
configurator
  • 2,796
  • 2
  • 21
  • 23
9
votes
2 answers

What defines a standard?

What defines a standard like HTML5, C++0x, etc.? Is it just that you hand something in to W3C/ANSI/ISO/..., they produce a couple hundred pages long document and suddenly it's a standard? Can't I, as an individual, create something and standardize…
Dave O.
  • 320
  • 1
  • 9
7
votes
1 answer

Is there a de facto standard documentor for Javascript?

I'm trying to document my code using JSDOC3, that has a similar syntax to PHPDocumentator / Apigen. But is there a de-facto standard for Javascript inline documentation? I think Google Closure is the most complete (or so it seems), but what is…
pocesar
  • 241
  • 1
  • 6
7
votes
1 answer

Standardized code documentation format, where is it?

I'm currently looking into API documentation generation tools and I noticed that apparently there are no efforts going on in standardization. Javadoc style is kind of an ubiquitous convention... it is used for Java (duh), PHP (PHPDocumentor,…
dukeofgaming
  • 13,943
  • 6
  • 50
  • 77
5
votes
3 answers

Standardized Programming Languages

Is there an organization similar to W3C that creates standards for programming languages? If so, are there any programming languages, like browsers would using W3C standards, that implement these standards? I have done my own research and I have…
ThreaT
  • 217
  • 2
  • 9
5
votes
5 answers

Standards in Enterprise Development

Is it perhaps time for enterprise systems to be developed to strict enforced standards? Many books list optional 'standards' and best practices, but these are purely suggested practices. Still, every time I look at the code for an enterprise system…
Paul T Davies
  • 3,144
  • 2
  • 22
  • 22
4
votes
1 answer

Different operators in query string like ?var!=value

This one may actually be 2 questions in one. Studying some APIs I came across an api suggesting to have operand different from equal (=) inside the query string…
Aslabs
  • 163
  • 1
  • 1
  • 4
1
2 3