Method and system for automatic documentation of configurable systems

• US 20060206789A1
• Filed: 03/11/2005
• Published: 09/14/2006
• Est. Priority Date: 01/11/2000
• Status: Active Grant

• Current Assignee: Versata Incorporated (ESW Capital, LLC)
• Original Assignee: Ecora.com Corporation
• Inventors: Hulubei, Tudor, Bakman, Alexander, Sabin, Daniel, Wertsberger, Shalom
• Granted Patent: US 9,959,115 B2
• Time in Patent Office: Days
• US Class Current: 715/234
• CPC Class Codes: G06F 8/71 Version control security arrangements therefor G06F21/57; Configuration management
• CPC Class Codes: G06F 8/73 Program documentation
• CPC Class Codes: G06F 9/44505 Configuring for program initiating, e.g. using registry, configuration files

Abstract

An automatic documentation generation and management system and method, for documenting configurable systems such as complex software applications and hardware systems is disclosed. The method retrieves configuration parameters from the configurable system and utilizes them to automatically generate an explanatory document specific to the configured system. The invention also discloses a documentation appliance system, which is a dedicated documentation server coupled to the configurable system via a communication network, preferably via an Intranet. In yet another alternative, the invention may be practiced by integrating code for automatic documentation generation within the configurable system program.

Claims

1-90. -90. (canceled)

91. A method for automatic production of documentation for configurable computerized systems, comprising the steps of:

retrieving configuration parameters having values associated therewith, from a configurable system;

storing a first set of configuration parameters from a configurable system;

storing a second set of configuration parameters from a configurable system; and

outputting differences between said first and second sets of configuration parameters.

92. The method of claim 91 further comprising the steps of:

outputting explanatory information corresponding to at least one of said configuration parameters and a value associated with said parameter; and

organizing said explanatory information, based on at least one of a content of said information and said value associated with said parameter, into a narrative format descriptive of the configuration of the configurable system, the narrative format constituting the documentation, or a portion of the documentation, for said configurable system.

93. The method of claim 91, wherein said first and second set of configuration parameters are retrieved from the same system.

94. The method of claim 91, wherein one of said first set and second set of configuration parameters is retrieved from a reference configuration system.

95. The method of claim 92, further comprising the step of constructing a table of contents for said documentation, or a portion thereof.

96. The method of claim 92, further comprising the step of generating an index of at least selected parameters of said configuration parameters, and said explanatory information, said index detailing relative location of at least one of said selected parameters and at least a portion of said explanatory information within said document.

97. A system for automatic production of documentation for configurable computerized systems, comprising:

a first computer having data communication capability;

means for retrieving configuration parameters from a configurable system and communicating said parameters into said first computer;

means for storing at least a first and a second set of said configuration parameters; and

means for outputting said difference between said first and second set.

98. The system of claim 97 further comprising:

means for generating explanatory information specific to said configurable system in accordance with said configuration parameters;

means for organizing said explanatory information, based on at least one of a content of said explanatory information and values associated with said configuration parameters, into a narrative format descriptive of the configuration of the configurable system, the narrative format constituting a documentation, or a portion of said documentation, for said configurable system; and

means for outputting said documentation.

99. The system of claim 97, wherein said first and second set of configuration parameters are retrieved from the same system.

100. The system of claim 97, wherein one of said first set and second set of configuration parameters is retrieved from a reference configuration system.

101. The system of claim 97, wherein said configurable system is a configurable system of said first computer.

102. A system for automatic production of documentation for configurable computerized systems, comprising:

a) a collector computer program adapted to retrieve configuration parameters from at least one configurable system; and

b) a documentation generator program communicating with said collector program, and outputting explanatory information associated with said configuration parameters,

wherein said system is further adapted to store at least a first and a second set of said configuration parameters and to output difference between said first and second set.

103. The system of claim 102 further comprising:

a parser adapted to parse said configuration parameters into associated values and merge said values into a template; and

an output module adapted to organize said explanatory information, based on at least one of a content of said explanatory information and said values associated with said configuration parameters and to output said template with said merged values in a narrative format descriptive of the configuration of the configurable system, to form the documentation or a portion of said documentation, for said at least one configurable system.

104. The system of claim 102, wherein said first and second set of configuration parameters are retrieved from the same system.

105. The system of claim 102, wherein one of said first set and second set of configuration parameters is retrieved from a reference configuration system.

106. A method for automated production of documentation for configurable computerized system, comprising the steps of:

downloading a collector computer program to a first computer which is in communication with a configurable system;

collecting configuration parameters from said configurable system using said collector program;

transmitting said configuration parameters into a second computer having a documentation generator program operable thereon;

storing a first and a second set of configuration parameters;

comparing said first set and second set; and

outputting differences therebetween.

107. The method of claim 106 further comprising outputting, using said documentation generation program, a document in a narrative format descriptive of the configuration of the configurable system, said document comprising:

i. explanatory information, regarding at least a portion of said configuration parameters;

ii. said portion of said configuration parameters; and

iii. a table of contents detailing relative location of at least certain segments of said explanatory information.

108. The method of claim 106, wherein said first and second set of configuration parameters are retrieved from the same system.

109. The method of claim 106, wherein one of said first set and second set of configuration parameters is retrieved from a reference configuration system.

110. A method for automatic production of documentation for configurable computerized systems, comprising the steps of:

coupling a computer with at least a portion of a configurable system via a network;

retrieving configuration parameters having values associated therewith, from said configurable system into said computer;

outputting explanatory information corresponding with at least one of said configuration parameters and a value associated with said parameter;

storing a first set of configuration parameters from a configurable system;

storing a second set of configuration parameters from a configurable system; and

outputting differences between said first and second sets of configuration parameters.

111. The method of claim 110 further comprising organizing said explanatory information, based on at least one of a content of said information and said value associated with said parameter, into a narrative format descriptive of the configuration of the configurable system, the narrative format constituting the documentation, or a portion of the documentation, for said configurable system.

112. The method of claim 110, wherein said first and second set of configuration parameters are retrieved from the same system.

113. The method of claim 110, wherein one of said first set and second set of configuration parameters is retrieved from a reference configuration system.

114. The method of claim 111, further comprising constructing a table of contents for said documentation, or a portion thereof.

115. The method of claim 110, further comprising maintaining an activity log detailing operations of said steps of retrieving and outputting.

116. The method of claim 110, further comprising generating an index of at least selected parameters of said configuration parameters, and said explanatory information, said index detailing relative location of at least one of said selected parameters and at least a portion of said explanatory information within said document.

117. A system for automatic production of documentation for configurable computerized systems, comprising:

a computer adapted to be coupled to a configurable system via a network;

means for retrieving configuration parameters from said configurable system into said computer;

means for generating explanatory information specific to said configurable system in accordance with said configuration parameters;

means for outputting said documentation; and

means for storing at least a first and a second set of said configuration parameters,

wherein said means for outputting said documentation is further adapted to output difference between said first and second set.

118. The system of claim 117 further comprising means for organizing said explanatory information, based on at least one of a content of said explanatory information and values associated with said configuration parameters, into a narrative format descriptive of the configuration of the configurable system, the narrative format constituting a documentation, or a portion of said documentation, for said configurable system.

119. The system of claim 117, wherein said first and second set of configuration parameters are retrieved from the same system.

120. The system of claim 117, wherein one of said first set and second set of configuration parameters is retrieved from a reference configuration system.

121. A system for automatic production of documentation for configurable computerized systems, comprising:

a) a computer coupled to said configurable system via a network; and

b) a collector program module operated on said computer and adapted to retrieve configuration parameters from at least one configurable system;

wherein said system is adapted to store at least a first and a second set of said configuration parameters and to output difference between said first and second set.

122. The system of claim 121 further comprising c) a documentation generator program module comprising:

i. a template having explanatory information and place holders indicating placement of one or more configuration parameters;

ii. a data parser in communication with said collector program module, said parser adapted to parse said configuration parameters into associated values and merge said values into said template; and

iii. an output module adapted to organize said explanatory information, based on at least one of a content of said explanatory information and said values associated with said configuration parameters, and to output said template with said merged values in a narrative format descriptive of the configuration of the configurable system, to form the documentation or a portion of said documentation, for said at least one configurable system,

123. The system of claim 121, wherein said first and second set of configuration parameters are retrieved from the same system.

124. The system of claim 121, wherein one of said first set and second set of configuration parameters is retrieved from a reference configuration system.

125. A method for automated production of documentation for configurable computerized system, comprising the steps of:

retrieving configuration parameters from a configurable system, into a computer that is in communication with said configurable system via a network;

selecting explanatory information in accordance with said configuration parameters;

outputting a document comprising;

i. said explanatory information; and

ii. values associated with said configuration parameters;

storing a first and a second set of configuration parameters; and

comparing said first set and second set and outputting differences therebetween.

126. The method of claim 125, wherein said document is in a narrative format descriptive of the configuration of the configurable system.

127. The method of claim 125, wherein said document further comprises iii. a table of contents detailing relative location of at least certain segments of said explanatory information.

128. The method of claim 125, wherein said first and second set of configuration parameters are retrieved from the same system.

129. The method of claim 125, wherein one of said first set and second set of configuration parameters is retrieved from a reference configuration system.

130. A self documenting configurable system, comprising:

a) explanatory information related to said configurable system; and

b) at least one software module constructed to merge a plurality of configuration parameters of said configurable system with corresponding portions of said explanatory information related to said configurable system,

wherein said system is adapted to store at least a first and a second set of said configuration parameters and to output difference between said first and second set.

131. The system of claim 130, wherein at least one software module is constructed to

i. organize said explanatory information, based on at least one of a content of said explanatory information and values associated with said configuration parameters, and

ii. output said explanatory information and said configuration parameters in a narrative format descriptive of the configuration of the configurable system, to form a document specific to an instance of said configurable system.

132. The system of claim 130, wherein said first and second set of configuration parameters are retrieved from the same system.

133. The system of claim 130, wherein one of said first set and second set of configuration parameters is retrieved from a reference configuration system.

134. A method for automated production of documentation for a configurable software system, having at least a portion of its behavior modifiable by configuration parameters stored in a computer accessible store, said method comprising the steps of:

embedding into said configurable software system a software module constructed to merge configuration parameters and explanatory information associated with said configuration parameters;

retrieving said configuration parameters, said configuration parameters having values associated therewith, from said configurable system into a computer;

outputting explanatory information corresponding with at least one of said configuration parameters and a value associated with said parameter;

storing a first and a second set of configuration parameters; and

comparing said first set and second set and outputting differences therebetween.

135. The method of claim 134 further comprising organizing said explanatory information, based on at least one of a content of said information and said value associated with said parameter, into a narrative format descriptive of the configuration of the configurable system, the narrative format constituting the documentation, or a portion of the documentation, describing specifically said configurable software system as configured.

136. The method of claim 134, wherein said first and second set of configuration parameters are retrieved from the same system.

137. The method of claim 134, wherein one of said first set and second set of configuration parameters is retrieved from a reference configuration system.

138. A self documenting configurable software system having configuration parameters stored in at least one computer data store, comprising:

a) a first software module constructed to retrieve at least a portion of said configuration parameters from said computer data store; and

c) a second software module constructed to merge explanatory information and related parameters of at least said portion of said configuration parameters,

wherein said system is adapted to store at least a first and a second set of said configuration parameters and to output difference between said first and second set.

139. The system of claim 138, wherein said second software module is further constructed to organize said explanatory information, based on at least one of a content of said information and values associated with said relates parameters, into a narrative format descriptive of the configuration of the configurable system, the narrative format constituting a document, or a portion of the document, containing a description specific to said configurable system.

140. The system of claim 138 wherein said first and second module constitute a single module.

141. The system of claim 138, wherein said first and second set of configuration parameters are retrieved from the same system.

142. The system of claim 138, wherein one of said first set and second set of configuration parameters is retrieved from a reference configuration system.