Bug 769137

Summary: F16 Planet CCRMA Documentation links to F13 Repo
Product: [Fedora] Fedora Documentation Reporter: noti peppas <fedora-project>
Component: musicians-guideAssignee: Christopher Antila <christopher>
Status: CLOSED CURRENTRELEASE QA Contact: Fedora Docs QA <docs-qa>
Severity: low Docs Contact:
Priority: unspecified    
Version: develCC: zach
Target Milestone: ---   
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2013-01-19 18:02:38 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description noti peppas 2011-12-20 02:27:13 UTC
Description of problem:
The Fedora 16 CC

Version-Release number of selected component (if applicable):
Fedora 16 Musician's Guide: Edition 1.0

How reproducible:
Always.

Steps to Reproduce:
1. visit http://docs.fedoraproject.org/en-US/Fedora/16/html/Musicians_Guide/sect-Musicians_Guide-Using_Planet_CCRMA_Software.html
2. Observe the links point to the Fedora 13 repositories.
  
Actual results:
su -c 'rpm -Uvh http://ccrma.stanford.edu/planetccrma/mirror/fedora/linux/\
planetccrma/13/i386/planetccrma-repo-1.1-2.fc13.ccrma.noarch.rpm

Expected results:
su -c 'rpm -Uvh http://ccrma.stanford.edu/planetccrma/mirror/fedora/linux/\
planetccrma/16/i386/planetccrma-repo-1.1-3.fc16.ccrma.noarch.rpm

Comment 1 Christopher Antila 2011-12-20 03:02:05 UTC
Thanks for your report.

This in itself is not a bug because:
1.) The PlanetCCRMA repository for a particular Fedora release is not usually made available until months after the GA release for Fedora.
2.) If somebody tries to install the RPM file for their release, and it doesn't exist, they may simply give up.
3.) If you follow steps in Section 4.3.1, you will update the Fedora 13 repository file to the most current in steps 3 through 5.

I decided it's better to leave the link alone than to change it with every release.

But:
1.) I'll update the version number to '16' for the Fedora 17 Musicians' Guide.
2.) It looks like I haven't touched Section 4.3 since first draft. It's poorly formatted, poorly written, and doesn't follow the Fedora style guidelines.
3.) There's actually no need to use the rpm command... I should replace it with the equivalent yum command.
4.) There should be an admonition warning that it's okay to install the apparently-outdated package, and explaining why.

After I (or somebody) rewrites Section 4.3, you (bugs) will have the opportunity to provide additional feedback before the updated version is published.

Comment 2 Christopher Antila 2012-05-24 01:46:30 UTC
I fixed this in the current draft version.[1] Please let me know whether you feel this is a sufficient change, or I should add additional information.

[1] https://docs.fedoraproject.org/en-US/Fedora_Draft_Documentation/0.1/html/Musicians_Guide/sect-Musicians_Guide-Using_Planet_CCRMA_Software.html#sect-Musicians_Guide-CCRMA_Installing_Repository

Comment 3 Christopher Antila 2013-01-19 18:02:38 UTC
The update was published with Fedora 18.

https://docs.fedoraproject.org/en-US/Fedora/18/html/Musicians_Guide/index.html

I'm closing this bug. If you feel the fix is insufficient, please re-open it.