Port Function to Handle OS Upgrades

[Mark Hattam]

On 23 Oct 2009, at 21:29, Ryan Schmidt wrote:

>>
>>> These are each FAQ lines in their own right as far as I can see.   
>>> I very much think I represent the end user to a degree.  Not  
>>> afraid to read at all, but man pages often times lack examples,  
>>> which are some of the best ways to learn for me.
>>
>> I'd disagree as I've had to help far too many and deal with far too  
>> many tickets that should have dealt with be a knowledgeable user.
>>
>> Most didn't even read the Migration page.
>
>
> I'm not sure I understand your responses to Scott here.
>
> Scott's saying we don't have enough documentation on how to use  
> MacPorts. You're saying users don't read the documentation we do  
> have. Is that right? If that's true, then we either need to  
> publicise the available documentation better, or simplify it so it's  
> more understandable to end users.


Goes back to the website issue ...
start at  http://www.macports.org

try and find quickly the procedures involved in going from a working  
MacPorts on 10.5 to 10.6

There's no search facility.

The "Home" page doesn't link directly to what is effectively a "hot  
issue"
The "Installing MacPorts" deals with new installs and upgrading those  
installs
The "Available Ports" doesn't deal (obvious really)
The "Documentation" (which goes to guide.macports.org) doesn't deal  
with migrating
The "Support and Development" (which goes to trac.macports.org) does  
have a "migration" link ... YIPPEE
The "Contact Us" again isn't designed to deal ... but does a link to  
"Problems hotlist" ... but "migration" isn't covered there.
The "News" page doesn't have a link to Migration, yet surely osx 10.6  
release would have counted as some sort of news if only to give an  
opportunity for a "migration" link.

Also, you tend to have to know that "migration" is the keyword to look  
out for.

Googling something like    macports 10.6 upgrade
doesn't find any hits on macports.org apart from tickets for things  
that didn't work.


Oh and while we're there ... what's the "Download" link do at the top  
right of the pages?
When you're already on the
http://www.macports.org/install.php
page, it just sends you to the same page.


Mark