Sun
   Microsystems              Systems Architecture Committee
_________________________________________________________________

Subject:	Command Assistant

Submitted by:	Pu Chen

File:		PSARC/2008/772/opinion.txt

Date:		June 17th, 2008.

Committee:	James Carlson (opinion  written  by  Mark Martin),
			Glenn Skinner, Rick Matthews, Sebastien Roy, Kais Belgaied,
			Garrett D'Amore, Mark A. Carlson
	
		
Product Approval Committee:
		Solaris PAC
		solaris-pac-opinion@sun.com

1.  Summary

The purpose of this project (Command Assistant) is to provide an easy access to
OpenSolaris documentations manpages and javadoc in the context of specific
command usage to users.

2.  Decision & Precedence Information

The project is approved as specified in reference [1].

The project may be delivered in a minor release of OpenSolaris.


3.  Interfaces

The project exports the following interfaces.

Client Interfaces: 

    Uncommitted:
             /usr/lib/bonobo/server/CommandAssistant_Applet.server
             /usr/lib/CommandAssistant/commandassistant-applet
             /usr/lib/CommandAssistant/config.xml

    Committed:
             http://ww.opensolaris.com/commandassistant/service?wsdl
             (Web service interface)

4.  Opinion

The committee expressed concern over the ability for third parties to submit
documentation. The committee also expressed some concern over the potential
possibility of documentation being available via the externally available
service being out of sync with what is currently installed on the user's system.
It may not be clear to users that this browser displays documentation that is
external to the system, and as such, may not reflect what is actually installed
on that system. The ability for third parties to submit documentation is not in
scope for this project, nor is accounting for variation between versions of
products shown in the tool and installed on the system . This project is
sufficiently scoped to deliver a vary narrowly focused, but useful tool.

The committee expressed concern over the project's plan to use java as the
client platform. The project team addressed this concern, and revised their
implemenation to integrate as a Gnome applet. This change is reflected
in the post inception materials, found in the "post-inception.materials"
directory.

5.  Minority Opinion(s)

None.

6.  Advisory Information

None.

7.  Appendices

7.1.  Appendix A: Technical Changes Required

None.

7.2.  Appendix B: Technical Changes Advised

None.

7.3.  Appendix C: Reference Material

Unless stated otherwise, path names are relative to the case directory
PSARC/2008/772.

1    Onepager
     File: onepager

2    Inception minutes
     File: 20090225.2008.772.commitment

3    Issues
     File: issues

4    PSARC 20 Questions.
     File: post-inception.materials/20_questions_Command_Assistant.txt

5    Security 
     File: final.materials/security.txt


PSARC/2008/772               Copyright 2008 Sun Microsystems