<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://www.w3.org/Bugs/Public/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4"
          urlbase="https://www.w3.org/Bugs/Public/"
          
          maintainer="sysbot+bugzilla@w3.org"
>

    <bug>
          <bug_id>1059</bug_id>
          
          <creation_ts>2005-01-26 14:56:35 +0000</creation_ts>
          <short_desc>Parsing the definition of specification</short_desc>
          <delta_ts>2005-04-28 11:53:52 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>QA</product>
          <component>QASpec-GL</component>
          <version>LC-2004-11-22</version>
          <rep_platform>All</rep_platform>
          <op_sys>All</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>REMIND</resolution>
          
          
          <bug_file_loc>http://lists.w3.org/Archives/Public/www-qa/2005Jan/0034.html</bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>P2</priority>
          <bug_severity>minor</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Dominique Hazael-Massieux">dom</reporter>
          <assigned_to name="Karl Dubost">karl</assigned_to>
          
          
          <qa_contact name="Karl Dubost">karl</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>2913</commentid>
    <comment_count>0</comment_count>
    <who name="Dominique Hazael-Massieux">dom</who>
    <bug_when>2005-01-26 14:56:35 +0000</bug_when>
    <thetext>I found it difficult to parse and understand the definition of 
specification.  It says &quot;...interface to accomplish a task.&quot;  But 
interfaces are static, passive entities.  They don&apos;t accomplish 
anything.  Perhaps &quot;for accomplishing a task&quot; would read better, but 
even that feels uncomfortable.  What task does XML accomplish?  (It is 
used for many more things besides machine-independent data interchange.)

I&apos;m not sure that this phrase is necessary at all.  Saying that &quot;A 
specification is a set of technical requirements which define a reliable 
interface.&quot; seems adequate.  If really necessary to qualify &quot;interface&quot;, 
then &quot;interface between actors&quot; is what I&apos;d suggest.

On the same sentence, though less important, the phrase &quot;which aim at 
...&quot; is one of those unnecessary phrases (like &quot;in order to&quot;) that are 
best removed.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>4010</commentid>
    <comment_count>1</comment_count>
    <who name="Dominique Hazael-Massieux">dom</who>
    <bug_when>2005-03-07 17:40:39 +0000</bug_when>
    <thetext>http://lists.w3.org/Archives/Public/www-qa-wg/2005Mar/0018.html
http://www.w3.org/Bugs/Public/show_bug.cgi?id=1059 suggests that our
definition of specification is hard to parse; firstly, because it&apos;s not
in proper English, with a suggested rewording:
&quot;&quot;&quot;A specification is a set of technical requirements which aim at
defining a reliable interface for accomplishing a given task&quot;&quot;&quot;
(instead of &quot;to accomplish&quot;) that I think is good.

Then the commenter argues that an interface can&apos;t accomplish anything -
it&apos;s passive entity; of course I agree that an interface can&apos;t
accomplish anything, but I think the new sentence only says that the
interface defined should be reliable for accomplishing a given task. So
unless anybody disagrees, I suggest simply changing &quot;to accomplish&quot; into
&quot;for accomplishing&quot;.

(I plan to send several editorial issues proposals, that I think should
be formally adopted in batch during next week teleconf - but discussing
them beforehand on the mailing list would help that a lot)

Dom</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>3833</commentid>
    <comment_count>2</comment_count>
    <who name="Dominique Hazael-Massieux">dom</who>
    <bug_when>2005-04-08 08:42:36 +0000</bug_when>
    <thetext>http://www.w3.org/2005/03/21-qa-minutes.html
RESOLUTION: to use ISO&apos;s definition of &quot;specification&quot; for SpecGL and ViS,
referencing ISO Guide 2-4

ISO definition: 
Specification: document that prescribes requirements to be fulfilled by a
product, process, or service. </thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>3699</commentid>
    <comment_count>3</comment_count>
    <who name="Dominique Hazael-Massieux">dom</who>
    <bug_when>2005-04-28 11:53:52 +0000</bug_when>
    <thetext>setting version to LC in case of future use</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>