systemml-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Frederick R Reiss" <frre...@us.ibm.com>
Subject Re: [DISCUSS] Version-specific documentation
Date Wed, 22 Jun 2016 17:44:19 GMT
Having a separate language reference for each version is a good idea. Eventually we will have
users running backlevel versions of the system. We can cover that need by adding an "archive
the current state of the documentation" step to our release process. 
   
    Fred
  
  Sent from my iPhone using IBM Verse
  
  On Jun 21, 2016, 9:40:31 PM, mboehm@us.ibm.com wrote:
  
  From: mboehm@us.ibm.com
  To: dev@systemml.incubator.apache.org
  Cc: 
  Date: Jun 21, 2016 9:40:31 PM
  Subject: [DISCUSS] Version-specific documentation
  
  
     In the context of SYSTEMML-554, we aim to introduce native frame data type
   support. While porting the file-based transform, I intend to drop the
   existing transform scaling functionality (mean substraction, z-scoring) as
   it is more naturally expressed over matrices. However, this change raises a
   general question with regard to our documentation:
   How do you feel about maintaining version-specific language references? It
   would certainly help to avoid version-specific conflicts (e.g., builtin
   functions added in newer versions) but it might add overhead as fixes would
   need to go into multiple versions. Personally, I would be in favor of
   simply archiving the old documentation (but keeping it available) as part
   of our release process.
   Regards,
   Matthias

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message