web site ammendments for yum

[Raphael Clifford]

>
>
>> [...]
>> however it is recommended instead that you install one=20
>> of the automatic package management programs apt (XXX link to page with=20
>> apt packages for fedora-legacy and any info for unsupported redhat=20
>> versions XXX) or yum (XXX link to page with yum packages for=20
>> fedora-legacy and any info for unsupported redhat versions XXX).
>> [...]
>> After installing apt or yum, you may optionally set it up to use some=20
>> mirror sites.
>> [...]
>> Once you have got the preconfigured yum/apt packages installed you may=20
>> update packages on your system following the standard instructions here=20
>> (XXX link XXX)
>> [...]
>  
>

"
Sorry, but I don't understand how exactly this differs from the
instructions that can be found in the Documentation section. "Install
apt or yum", "Set up mirrors", "Update your system"... it looks like a
short summary of the full documentation to me, leaving out at least the
important part of importing the Fedora Legacy GPG key which isn't too
obvious even to experienced users.

I don't think we should put even more documentation onto the Download
page as we have a separate Documentation page. From my point of view,
the download page should only used by users that know what to do and
just need the according information (e.g. where are the repositories,
what channels are provided, what do I have to put in my repository
configuration).

"

That is OK but see comments below..

"
It does no good if we try to hold the hand of people who are not sure
how to handle this information. These people should go to the
Documentation page, and the Download page should strongly encourage them
to do so.

"


The motivation is to have a page a non-expert can go to and by reading it and following the links be able to get yum or apt working on their system.  If there is another page that does the same thing then that is great but I haven't seen it.  

The Documentation page currently has three links and almost nothing else on it.  They are 


    * Using Fedora Legacy with yum on Red Hat 7.x
      <http://www.fedoralegacy.org/docs/yum-rh7x.php>
    * Using Fedora Legacy with apt on Red Hat 8.0
      <http://www.fedoralegacy.org/docs/apt-rh8.php>
    * How can I participate? <http://www.fedoralegacy.org/participate/>


This page is clearly only of use to people who want to do one of those 
three things and know what yum and apt are for. There is no mention of 
yum with redhat 8.0 etc. either.  It also doesn't contain any of the 
introductory text that the "download" page does have currently.  In 
general it isn't an introductory document.  Also, much of the info for 
yum and redhat 7.x will be the same for any redhat version  (that is a 
side issue however).

The "Download" page has no links to where you can get apt or yum 
preconfigured from (for example). 

I don't mind at all where this page I am referring goes. I am only 
suggesting it would be good to have one. In that spirit I am suggesting 
what structure it could have. The idea behind the structure is to give 
enough info so that, read on its own, one knows which steps are required 
and that each step is clearly described by following one click.  If we 
can have one page that satisfies that condition I think we would be in 
much better shape. 

So how about

1) A documentation page which is introductory in style and contains all 
the info needed for a non-expert to get started with clearly annotated 
links for the detailed parts.  We could even call it a HOWTO :)  The FAQ 
doesn't help someone trying to get set up either at the moment.
2)  A download page that essentially just has links to where to download 
things from.

Cheers,
Raphael