Re: Notes from the Real World

From: jmjonesat_private
Date: Tue May 01 2001 - 15:34:17 PDT

  • Next message: Greg KH: "Re: Notes from the Real World"

    On Tue, 1 May 2001, Seth Arnold wrote:
    
    > * jmjonesat_private <jmjonesat_private> [010501 08:57]:
    > > Before I devise a benchmark program to do so, does anyone have
    > > any thoughts about exactly *what* you would like to see tested?
    > 
    > The first two that come to mind: lmbench and kernel compiles. (lmbench
    > can be downloaded from www.bitmover.com.)
    
    Done and done.  Anything else?
    
    > 
    > > Also, if anybody is interested in helping with the documentation 
    > 
    > I think I can also be useful here; however, I intend to hold off
    > starting until the code base reaches a more mature state. I think when a
    > few of the folks say they will begin porting their code to the new
    > structure is about the time to start documentation. Before that we run
    > the risk of documenting an old revision. :)
    > 
    
    True, but running documentation tandem to development has the following
    advantages:
    
    * The thought and consideration that goes into documentation sometimes
      reveals ambiguities in the code.
    
    * While explaining the implementation, the combination of thoughts that
      result in understandable HUMAN LANGUAGE text sometimes reveals potential
      that is not realized in the code, which coders can slap their forehead
      about and exclaim "i never saw that!"
    
    * Having a working structure for documentation helps everyone visualize 
      where the implementation stands, and where it can or will go.
    
    I don't think "old revision" documentation is necessarily busy work, it 
    assists the coders in "cognifying" their efforts.  I *do* see that it's a 
    bit early, in this particular project... but "the day is coming soon" and 
    I'd like to help us to be ready.
    
    > -- 
    > Earthlink: The #1 provider of unsolicited bulk email to the Internet.
    > 
    
    EEEEEEEEwwwwww... isn't that SPAM?!?!
    
    J. Melvin Jones
    
    |>------------------------------------------------------
    ||  J. MELVIN JONES            jmjonesat_private 
    |>------------------------------------------------------
    ||  Microcomputer Systems Consultant  
    ||  Software Developer
    ||  Web Site Design, Hosting, and Administration
    ||  Network and Systems Administration
    |>------------------------------------------------------
    ||  http://www.jmjones.com/
    |>------------------------------------------------------
    
    
    _______________________________________________
    linux-security-module mailing list
    linux-security-moduleat_private
    http://mail.wirex.com/mailman/listinfo/linux-security-module
    



    This archive was generated by hypermail 2b30 : Tue May 01 2001 - 15:36:05 PDT