SYSTEM AND METHOD OF GENERATING CUSTOMIZED DOCUMENTATION FOR A SOFTWARE PRODUCT

• US 20080271012A1
• Filed: 04/25/2007
• Published: 10/30/2008
• Est. Priority Date: 04/25/2007
• Status: Active Grant

• Current Assignee: International Business Machines Corporation
• Original Assignee: International Business Machines Corporation
• Inventors: Eykholt, Daniel C.
• Granted Patent: US 8,307,341 B2
• Time in Patent Office: Days
• US Class Current: 717/174
• CPC Class Codes: G06F 8/73 Program documentation

Abstract

A system and method for creating customized documentation is disclosed. The method comprises storing one or more documents such that each of the one or more documents corresponds to one of a plurality of versions of a software product. The version of the software product which is installed in an installation environment is detected. The configuration of the installation environment is also detected. At least one document from the one or more documents that corresponds to the version of the software product installed in the installation environment is selected. A subset of the selected document that includes the version of the software product installed in the installation environment and the configuration of the installation environment is then determined. A customized document is composed, based on one or more subsets of the selected document.

Claims

1. A computer program product comprising a computer useable medium having a computer readable program, wherein the computer readable program when executed on a computer causes the computer to:

detect which one of a plurality of versions of a software product is installed in an installation environment;

detect a configuration of the installation environment;

select a document from one or more documents that corresponds to the version of the software product installed in the installation environment;

determine a subset of the selected document that includes the version of the software product installed in the installation environment and the configuration of the installation environment; and

compose a customized document based on the subset of the selected document.

2. The computer program product of claim 1 wherein the one or more documents include support documentation on the software product.

3. The computer program product of claim 1 wherein the configuration is detected automatically by a discovery application.

4. The computer program product of claim 1 wherein the configuration is detected by receiving a selection from a user through one or more selection menus.

5. The computer program product of claim 1 wherein the configuration of the installation environment includes an operating system associated with the installation environment.

6. The computer program product of claim 1 wherein the configuration of the installation environment includes a listing of one or more hardware devices associated with the installation environment.

7. The computer program product of claim 1 wherein the configuration includes a listing of one or more applications associated within the installation environment.

8. The computer program product of claim 1 wherein the one or more documents are stored in a version control system.

9. The computer program product of claim 1 wherein the computer readable program when executed on a computer further causes the computer to save the configuration and automatically update the customized document based on the saved configuration.

10. The computer program product of claim 1 wherein the customized document is composed in response to a report by a customer of an issue with the software product.

11. The computer program product of claim 10 wherein the computer readable program when executed on a computer further causes the computer to:

identify a potential deficiency in the customized document if the issue reported by the customer is not addressed by the customized document;

identify a corresponding deficiency in the subset of the selected document from which the customized document was composed; and

revise the selected document to address the issue with the software product.

12. The computer program product of claim 11 wherein a determination is made that there is a deficiency in the customized document by monitoring a counter, the counter increased for each subsequent report of the same issue.

13. A method comprising:

detecting which one of a plurality of versions of a software product is installed in an installation environment;

detecting a configuration of the installation environment;

selecting a document from one or more documents that corresponds to the version of the software product installed in the installation environment;

determining a subset of the selected document that includes the version of the software product installed in the installation environment and the configuration of the installation environment; and

composing a customized document based on the subset of the selected document.

14. The method of claim 13 wherein the one or more documents include support documentation on the software product.

15. The method of claim 13 wherein detecting the configuration is performed automatically by a discovery application.

16. The method of claim 13 wherein detecting the configuration is performed by receiving a selection from a user through one or more selection menus.

17. The method of claim 13 wherein the configuration of the installation environment includes an operating system associated with the installation environment.

18. The method of claim 13 wherein the configuration of the installation environment includes a listing of one or more hardware devices associated with the installation environment.

19. The method of claim 13 wherein the configuration includes a listing of one or more applications associated within the installation environment.

20. The method of claim 13 wherein the one or more documents are stored in a version control system.

21. The method of claim 13 further comprising saving the configuration and automatically updating the customized document based on the saved configuration.

22. The method of claim 13 wherein the customized document is composed in response to a report by a customer of an issue with the software product.

23. The method of claim 22 further comprising:

identifying a potential deficiency in the customized document if the issue reported by the customer is not addressed by the customized document;

identifying a corresponding deficiency in the subset of the selected document from which the customized document was composed; and

revising the selected document to address the issue with the software product.

24. The method of claim 23 wherein a determination is made that there is a deficiency in the customized document by monitoring a counter, the counter having been increased for each subsequent report of the same issue.

25. A system comprising:

a document repository configured to store a plurality of documents, each document corresponding to one of a plurality of versions of a software product a discovery application configured to detect which one of the plurality of versions of the software product is installed in an installation environment and a configuration of the installation environment;

a document selection module configured to select a document from the one or more documents that corresponds to the version of the software product installed in the installation environment and further selecting one or more subsets of the selected document that corresponds to the configuration of the installation environment; and

a document generation module configured to compose a customized document based on the one or more subset of the selected document.

26. The system of claim 25 wherein the document selection module comprises a database engine.

27. The system of claim 25 wherein the plurality of documents include support documentation for the software product.

28. The system of claim 25 wherein the configuration of the installation environment includes an operating system associated with the installation environment.

29. The system of claim 25 wherein the configuration of the installation environment includes a listing of one or more hardware devices associated with the installation environment.

30. The system of claim 25 wherein the configuration includes a listing of one or more applications associated within the installation environment.

31. The system of claim 25 wherein the one or more documents are stored in a version control system.

32. The system of claim 25 wherein the configuration is saved and the customized document is automatically updated based on the saved configuration.

33. The system of claim 25 wherein the customized document is composed in response to a report by a customer of an issue with the software product.

34. The system of claim 33 further comprising:

a customer support module configured to identify a potential deficiency in the selected document if the issue reported by the customer is not addressed by the customized document and to further revise the selected document to address the issue with the software product.

35. The system of claim 34 wherein the customer support module further is configured to increment a counter with each subsequent report of the same issue and a determination is made that there is a deficiency in the customized document if the counter reaches a predetermined limit.