[bug-notifications] [pkg_get 0002971]: No installation instructions

[Mantis Bug Tracker]

A NOTE has been added to this issue. 
====================================================================== 
http://opencsw.org/bugtrack/view.php?id=2971 
====================================================================== 
Reported By:                kapilt
Assigned To:                phil
====================================================================== 
Project:                    pkg_get
Issue ID:                   2971
Category:                   other
Reproducibility:            always
Severity:                   major
Priority:                   normal
Status:                     feedback
====================================================================== 
Date Submitted:             2008-12-16 23:13 CET
Last Modified:              2009-03-10 09:12 CET
====================================================================== 
Summary:                    No installation instructions
Description: 
tried to get past the fork literature, and get on with using opencsw.
however there are no docs on how to actually install pkg-get. the user
manual completely skips it. seems like a a great way to attrition your user
base to zero. seriously, if you want people to use this stuff, you should
document how to install it.
====================================================================== 

---------------------------------------------------------------------- 
 (0005473) phil (manager) - 2008-12-19 17:11
 http://opencsw.org/bugtrack/view.php?id=2971#c5473 
---------------------------------------------------------------------- 
There IS documentation on how to install. However, perhaps you followed a
path that did not lead you to the docs.

What "user manual" are you referring to, that does not tell you how to
install it?

when you say "manual", I think "Man page". however, if you are reading the
manpage, then isnt it already installed? :-) 

---------------------------------------------------------------------- 
 (0005584) philadmin (administrator) - 2009-02-27 18:09
 http://opencsw.org/bugtrack/view.php?id=2971#c5584 
---------------------------------------------------------------------- 
user unresponsive as to specific needs. closing after 3 months. 

---------------------------------------------------------------------- 
 (0005592) kapilt (reporter) - 2009-02-28 19:27
 http://opencsw.org/bugtrack/view.php?id=2971#c5592 
---------------------------------------------------------------------- 
okay, say i come to the opencsw.org site, and i want to use opencsw.
nothing obvious on the home page. so i click on the next obvious link. the
user guide link. i get a documentation page without any information on how
to actual install opencsw, just how to use it. 

---------------------------------------------------------------------- 
 (0005611) automatthias (reporter) - 2009-03-09 09:08
 http://opencsw.org/bugtrack/view.php?id=2971#c5611 
---------------------------------------------------------------------- 
I think kapilt means that opencsw.org should have a page similar to
http://www.blastwave.org/howto.html - that is, a page which explains how to
install pkg-get. In other words, instructions how to get started with
opencsw.org with no previous knowledge of it.

I'd suggest putting on the main page, http://www.opencsw.org/, something
along the lines of:

-----------------------------------------------------------------------
pkgadd -d http://www.ibiblio.org/pub/solaris/opencsw/pkg_get.pkg all
echo >> /etc/opt/csw/pkg-get.conf \
  "url=ftp://ftp.heanet.ie/pub/opencsw/current/"
pkg-get -U
pkg-get -i vim
----------------------------------------------------------------------- 

---------------------------------------------------------------------- 
 (0005613) phil (manager) - 2009-03-09 17:21
 http://opencsw.org/bugtrack/view.php?id=2971#c5613 
---------------------------------------------------------------------- 
I updated things a bit. Please let me know if this helps enough.
Hopefully, the front page is a bit more blatant about "go read this page"
now. 

---------------------------------------------------------------------- 
 (0005617) automatthias (reporter) - 2009-03-10 09:12
 http://opencsw.org/bugtrack/view.php?id=2971#c5617 
---------------------------------------------------------------------- 
The new sentence on the front page, "Please see the pkg-get page for
details on how to get started with it" definitely helps. If there was an
"Installation" header in front of it, it would be even better! 

Issue History 
Date Modified    Username       Field                    Change               
====================================================================== 
2008-12-16 23:13 kapilt         New Issue                                    
2008-12-19 17:09 phil           Status                   new => assigned     
2008-12-19 17:09 phil           Assigned To               => phil            
2008-12-19 17:11 phil           Note Added: 0005473                          
2009-02-27 18:09 philadmin      Note Added: 0005584                          
2009-02-27 18:09 philadmin      Status                   assigned => resolved
2009-02-27 18:09 philadmin      Resolution               open => not fixable 
2009-02-27 18:15 philadmin      Status                   resolved => closed  
2009-02-28 19:27 kapilt         Note Added: 0005592                          
2009-02-28 19:27 kapilt         Status                   closed => feedback  
2009-02-28 19:27 kapilt         Resolution               not fixable => reopened
2009-03-09 09:08 automatthias   Note Added: 0005611                          
2009-03-09 17:21 phil           Note Added: 0005613                          
2009-03-10 09:12 automatthias   Note Added: 0005617                          
======================================================================