The workflow docs could use some love

[daviddavis]

I think the workflow docs have probably become out of date and thus are pretty confusing or almost unusable. To give couple examples I ran into today:

• The upload doc doesn't mention the pulp rpm content upload command. Instead, it has users go through the painful process of creating an artifact and then a package.
• Lots of the samples don't make sense like the pulp-cli example for creating a repo here exports a $REPO_HREF var (why?)

It's probably worth going through and revamping the docs.

[dralley]

Completely agreed

[javihernandez]

As a 7 months-old user of pulp, I can tell that, yes, docs are confusing, specially in the beginning. You start playing with pulp, checking the docs, APIs, going back and forth to them + Postman .. kind of frustrating until you get it 😓
Also, is there an easy way to check older versions of the API on readthedocs? i.e.: we're still using 3.17 but currently online docs/API specs are for 3.19

Thanks guys!

[dralley]

I'm going to mark this as a duplicate of #2288, but copy over the specific cases called out here.