Question: Since this webstack is a HUGE feature improvement to SXDE 01/08, should'nt the default Firefox browser page that you see after logging into SXDE JDS Desktop be updated to have a sentence or two, plus a link to these Sun Docs? The file is: file:///usr/share/doc/soldevx/html/developer_guide.html It has links and mention of all the other SW stacks.
Neal Arvind Srinivasan wrote: > Apologies for the HTML formatting. > > http://docsview.sfbay/app/docs/doc/820-3877/6nfcnaoq2?a=view > > "This page contains links to commonly referenced information in about > the Web Stack components that is are part of Solaris Express Developer > Edition 01/08 release." > > http://docsview.sfbay/app/docs/doc/820-3883/6nfct1s63?a=view > There doesn't seem to be a consistent way of referring to this > release. In this page I see the following used - Solaris^TM Operating > System, Solaris platform, Solaris Operating System 5.11, Solaris OS > > "Solaris OS provides a user interface.." > I don't think it is accurate to say that the operating system provides > a user interface. > > "The Launch menu provides menu options to start or stop the server," > *the server* implies a single server. That isn't true. > > " Apache is the most popular web server on the internet.Web Server > that serves web pages in response to requests from users' web browsers." > > "MySQL is the world's most popular open-source database management > system. a relational database engine used to store most dynamic data." > > "PHP module with MySQL and PostgreSQL database support is provided for > Apache HTTP (32-bit) Pre-fork MPM. PHP module is integrated with the > NetBeans IDE." > I think this is wrong/bad English. > > "However, you can edit the PHP extension specific INI file for any > specific configuration changes. For example, to enable or disable the > extension, edit the PHP extension specific INI file." > Don't the 2 sentences say the same thing? > > More consistency issues - "PHP extensions", "PHP Extensions" > > "Ruby on Rails is the a framework for web application development. > Ruby is the an object-oriented programming language." > > "memcached" font is different. > > "NetBeans 6.0, the modular, standards-based, integrated development > environment (IDE) written in the Java programming language" > where did you get this from? > > "On the Solaris platform is provided an out-of-the-box experience to > use NetBeans IDE for scripting using your favorite scripting language > such as PHP or Ruby" > Poor English. > > "NetBeans PHP IDE modules are also integrated into the Solaris OS. " > Operating System means something very different. > > "Solaris OS also includes the Application Server for Java EE, commonly > known as Glassfish V5" > GlassFish V5??? I don't even think V3 is out. > > In general, I feel this page should be rewritten. At least, the > descriptions of each of the components could be better. Some of them, > like PostgreSQL's, go into the process architecture of that component > while others just have a brief description. > > http://docsview.sfbay/app/docs/doc/820-3883/6nfct1s67?a=view > "Before you can use the Solaris web application development environment," > What is "the Solaris web application development environment"? > > "This action starts the MySQL database and starts the Apache 2 server." > > > "Setting Up MySQL Database" > > "MySQL 5.0.45 for Solaris includes files necessary to register with > the Service Management Facility for the Java^TM platform" > SMF for the *Java* platform? > > "There are two server processes required for the web application > environment ? an Apache web server with a built-in PHP interpreter and > a MySQL database engine. The Solaris user interface provides a > convenient means to start and stop both servers simultaneously." > I don't think this makes sense. I couldn't understand what information > it conveyed being under the File Layout section. > > "Rails provides a pure-Ruby development environment, from the AJAX in > the view" > from the AJAX in the view?? > > " > > * > > Make sure that you have initialized the environment for your > login account. > > * > > Make sure that the required components are started. > > " > The above text must be linked to the corresponding sections that > describe the steps to initialize the environment, the required components. > > I found it very tedious to give feedback using this cut/paste method. > I think we need to have a more efficient way of submitting > documentation feedback. Maybe a wiki? > > Arvind > ------------------------------------------------------------------------ > > _______________________________________________ > > > webstack-discuss mailing list > webstack-discuss at opensolaris.org > http://mail.opensolaris.org/mailman/listinfo/webstack-discuss >
