Bug 988522 - Our v1 Wiki docs are confusing v2 users
Summary: Our v1 Wiki docs are confusing v2 users
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Pulp
Classification: Retired
Component: documentation
Version: Master
Hardware: Unspecified
OS: Unspecified
medium
medium
Target Milestone: ---
: ---
Assignee: Randy Barlow
QA Contact: Preethi Thomas
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2013-07-25 18:42 UTC by Randy Barlow
Modified: 2014-10-21 18:43 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2014-10-21 18:43:43 UTC
Embargoed:


Attachments (Terms of Use)

Description Randy Barlow 2013-07-25 18:42:43 UTC
We occasionally have users who get confused by the documentation in our wiki (which is for v1) complaining that our pulp CLI does not work.

We should either eliminate that documentation (if we no longer need to document v1), or add red boxes all over it that say that it's for the old unsupported version, and they should see the new documentation (with a link).

Comment 1 Sayli Karmarkar 2013-09-20 04:36:05 UTC
Moving to NEW as it is not being worked on right now.

Comment 2 Barnaby Court 2013-11-04 13:49:51 UTC
Move back to pulp-bugs as it is low priority.  A fair amount of work has been completed.  When it gets picked up go back through the docs to figure out what additional needs to be done.

Comment 3 Randy Barlow 2014-10-02 20:29:32 UTC
I wasn't able to find this fedorahosted.org in Bugzilla's "External Bug Tracker" feature, but I filed this ticket with them:

https://fedorahosted.org/fedora-infrastructure/ticket/4553

I'm marking this as needsinfo until we hear back from them.

Comment 4 Randy Barlow 2014-10-03 13:48:23 UTC
Fedorahosted opted to put our Wiki into a deny rule in robots.txt, so search engines should not find our wiki anymore in the near future.

https://fedorahosted.org/robots.txt

Comment 5 Preethi Thomas 2014-10-15 12:46:31 UTC
verified

Comment 6 Randy Barlow 2014-10-21 15:26:47 UTC
I've reopened the fedorahosted bug about this:

https://fedorahosted.org/fedora-infrastructure/ticket/4553#comment:2

Comment 7 Brian Bouterse 2014-10-21 15:30:11 UTC
I'm re-opening this bug because we also need to robots.txt the user guide portion of pulpprojects.org/ using a robots.txt. I believe a disallow rule for the following is all that is needed:

/ug/*

Comment 8 Brian Bouterse 2014-10-21 15:42:04 UTC
Medium priority seems more appropriate, but leaving assigned to rbarlow

Comment 9 Randy Barlow 2014-10-21 18:43:43 UTC
fedorahosted is again showing the correct robots.txt.

Since the user guide is a separate website than this ticket is about, I'm going to close this ticket as resolved again. The user guide does very largely say "v1" at the top. We could file a ticket about changing its robots.txt if we wanted to, but the links to it also call it the "legacy" docs.


Note You need to log in before you can comment on or make changes to this bug.