LinuxQuestions.org
Review your favorite Linux distribution.
Home Forums Tutorials Articles Register
Go Back   LinuxQuestions.org > Forums > Non-*NIX Forums > General
User Name
Password
General This forum is for non-technical general discussion which can include both Linux and non-Linux topics. Have fun!

Notices


View Poll Results: Do you agree that defined used incorrectly:
Yes 0 0%
No 3 100.00%
Voters: 3. You may not vote on this poll

Reply
  Search this Thread
Old 07-19-2018, 11:42 PM   #1
bkelly
Member
 
Registered: Jan 2008
Distribution: Centos 7-4
Posts: 205

Rep: Reputation: 13
Use of word define in requirements


Please consider the use of the word define as used in the requirement for some software.

Quote:
The app shall define the equation for color as defined in reference ABC.
Just for reference the first Google response has:
Quote:
1. a statement of the exact meaning of a word, especially in a dictionary.
2. the degree of distinctness in outline of an object, image, or sound, especially of an image in a photograph or on a screen.
My position is that the first use is incorrect for two reasons. The program is to use it to set the equation within the app as specified in the document, not define it. Second there can be only one definition, that in the reference.

I have tried my first poll. Lets see what happens.
Edit: Oops, the poll question used defined rather than define. I don't see how to edit it.

Last edited by bkelly; 07-19-2018 at 11:45 PM.
 
Old 07-20-2018, 07:45 AM   #2
MensaWater
LQ Guru
 
Registered: May 2005
Location: Atlanta Georgia USA
Distribution: Redhat (RHEL), CentOS, Fedora, CoreOS, Debian, FreeBSD, HP-UX, Solaris, SCO
Posts: 7,831
Blog Entries: 15

Rep: Reputation: 1669Reputation: 1669Reputation: 1669Reputation: 1669Reputation: 1669Reputation: 1669Reputation: 1669Reputation: 1669Reputation: 1669Reputation: 1669Reputation: 1669
Since "define" is "defined" with more than one meaning focusing on the first meaning is "definitely" not correct.
 
Old 07-20-2018, 10:12 AM   #3
scasey
LQ Veteran
 
Registered: Feb 2013
Location: Tucson, AZ, USA
Distribution: CentOS 7.9.2009
Posts: 5,727

Rep: Reputation: 2211Reputation: 2211Reputation: 2211Reputation: 2211Reputation: 2211Reputation: 2211Reputation: 2211Reputation: 2211Reputation: 2211Reputation: 2211Reputation: 2211
Quote:
The app shall define the equation for color as defined in reference ABC.
is using define as a verb, not a noun.
Both of the definitions you posted appear to be definitions of define as a noun.

I find this:
Quote:
to determine or identify the essential qualities or meaning of
which fits with the "The app shall define..."

(I used merriam-webster.com)
 
Old 07-20-2018, 04:41 PM   #4
dugan
LQ Guru
 
Registered: Nov 2003
Location: Canada
Distribution: distro hopper
Posts: 11,223

Rep: Reputation: 5320Reputation: 5320Reputation: 5320Reputation: 5320Reputation: 5320Reputation: 5320Reputation: 5320Reputation: 5320Reputation: 5320Reputation: 5320Reputation: 5320
Quote:
The app shall define the equation for color as defined in reference ABC.
I am extremely confused as to what this is supposed to mean.

Is the requirement to just retype into "the app", verbatim, what's written down in "reference ABC"?
 
Old 07-20-2018, 04:49 PM   #5
scasey
LQ Veteran
 
Registered: Feb 2013
Location: Tucson, AZ, USA
Distribution: CentOS 7.9.2009
Posts: 5,727

Rep: Reputation: 2211Reputation: 2211Reputation: 2211Reputation: 2211Reputation: 2211Reputation: 2211Reputation: 2211Reputation: 2211Reputation: 2211Reputation: 2211Reputation: 2211
Quote:
Originally Posted by dugan View Post
I am extremely confused as to what this is supposed to mean.

Is the requirement to just retype into "the app", verbatim, what's written down in "reference ABC"?
That might be the case, but what's more likely, in my experience, is that "reference ABC" contains some narrative or pseudo code about the "definition" that needs to be implemented in the "app"

I'm reminded of a project I was on in the last century where the requirements were very clear about the calculation the program was to perform, but neither of us in the 2-man "data processing" department could figure out how to code it. It turned out to be easier to go back to the engineer that had provided the specs and teach him BASIC so he could write the one-line formula required.
 
Old 07-20-2018, 06:03 PM   #6
dugan
LQ Guru
 
Registered: Nov 2003
Location: Canada
Distribution: distro hopper
Posts: 11,223

Rep: Reputation: 5320Reputation: 5320Reputation: 5320Reputation: 5320Reputation: 5320Reputation: 5320Reputation: 5320Reputation: 5320Reputation: 5320Reputation: 5320Reputation: 5320
Quote:
Originally Posted by bkelly View Post
My position is that the first use is incorrect for two reasons.
Highly relevant question: are the requirements language-agnostic, or are they meant for a programming language where "define" has a technical meaning?
 
Old 07-23-2018, 11:03 AM   #7
bkelly
Member
 
Registered: Jan 2008
Distribution: Centos 7-4
Posts: 205

Original Poster
Rep: Reputation: 13
Dugan: The app sets the color equation IAW (In Accordance With) the reference material. (My words, not the document author, but reasonably certain.) This is a display application and the displayed colors are important.

Scasey: Re
Quote:
It turned out to be easier to go back to the engineer that had provided the specs and teach him BASIC so he could write the one-line formula required.
Understood and agreed. Many people that have never written code “think” they are the cat’s meow at writing requirements. They seldom change their opinion about themselves.

Dugan: The intent is very much to be language-angnositc. The meaning is definitely not similar to C language defines.
 
  


Reply



Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is Off
HTML code is Off



Similar Threads
Thread Thread Starter Forum Replies Last Post
How do I define a unique label in a #define macro? schmitta Programming 1 05-08-2014 07:23 AM
linux Script required for word by word comaprison from 2 carat separated files. rajeevdvedi2006 Linux - Newbie 1 05-29-2013 06:24 AM
[SOLVED] Find/Replace shell script that replaces word with other word in text, filenames yanom Programming 8 09-12-2012 12:29 AM
bash shell script read file word by word part 2 justina Programming 7 01-25-2011 01:19 PM
Problems Copying & Pasting In Word When Word Closes - Ubuntu davidx Linux - Software 3 10-22-2008 08:21 PM

LinuxQuestions.org > Forums > Non-*NIX Forums > General

All times are GMT -5. The time now is 04:17 AM.

Main Menu
Advertisement
My LQ
Write for LQ
LinuxQuestions.org is looking for people interested in writing Editorials, Articles, Reviews, and more. If you'd like to contribute content, let us know.
Main Menu
Syndicate
RSS1  Latest Threads
RSS1  LQ News
Twitter: @linuxquestions
Open Source Consulting | Domain Registration