RE: [ws-rx-editors] Annotation for issue number?

From
Patil, Sanjay <>
Date
2005-09-19T20:31:53+00:00
ID
Thread
RE: [ws-rx-editors] Annotation for issue number?
Not necessarily on each line, but a note 
with the issue # for an added paragraph, etc, would be enough. For example, 
the paragraph on lines 391 to 397 describes the new subelement  /wsrm:SequenceAcknowledgement/wsrm:Final. It 
will very useful for a reviewer to see the annotation for this paragraph to say 
- i019 and i028.

 

I guess the technique you describe below might work but I 
am not an expert on OO as you can tell :-) Preferably, it should not be 
required to hover the mouse on the text to see the notes and something akin to 
MS Word comments is desirable.

 

Thanks,

Sanjay

  

  
  From: Doug Davis [mailto:] 
  
Sent: Monday, Sep 19, 2005 12:45 PM
To: 
  
Subject: RE: [ws-rx-editors] 
  Annotation for issue number?

  

Oh, you mean on each specific line 
  that changed?  I thought you meant in the 'revision history' 
  section. 
Don't know if there's an easy 
  way to mark each line with the issue # w/o a lot of manual typing. 
  
Only thing I could think of would be to 
  temporarily change your user name to include the issue #, then the change 
  record would include it as part of the change  ;-) 
Kind of a hack though. 
-Doug 

  
    
    

      "Patil, Sanjay" 
        <> 
        
09/19/2005 03:38 PM 

      
        
          
          

            
              
To

            Doug 
              Davis/Raleigh/IBM@IBMUS, 
              <> 
          

            
              
cc

            
          

            
              
Subject

            RE: [ws-rx-editors] 
              Annotation for issue number?

        
          
          

            
            

  
Ah! Then I must 
  have missed the annotations/notes.  Could some one please educate me 
  about how to read the notes in the OO doc. 
  
Thanks, 
  
Sanjay 

  
  From: Doug Davis [mailto:] 
  
Sent: Monday, Sep 19, 2005 12:33 PM
To: 
  
Subject: Re: [ws-rx-editors] 
  Annotation for issue number?

I did that on my changes, and I see Umit did that 
  on hers so I think we're ok. 
-Doug 

  
    
    

      "Patil, Sanjay" 
        <> 
        
09/19/2005 03:06 PM 
        

      

        
          
          

            
              
To

            <> 
          

            
              
cc

            
          

            
              
Subject

            [ws-rx-editors] 
              Annotation for issue number?

        
          
          

            
            

Would it make sense to add 
  annotation with the issue number whenever
there are any changes made to the 
  spec text. I think it will make it
easier for the TC members to understand 
  where each change is originating
from. If a particular change is purely 
  editorial, we could say that in
the annotation.

In my experience 
  with other TCs, such annotations are quite useful
especially when the 
  drafts include changes for many 
  issues.

Thanks,
Sanjay