Pulp

In #1903, there was some back-and-forth about how to deal with encoding issues. Specifically, the question came down to whether or not Pulp is responsible for enforcing the correct encodings of spec file fields. RPM spec fields should be encoded as UTF-8, but it's not clear what Pulp should do in the case where an RPM doesn't follow that guidance. After a long discussion, our conclusion is that Pulp should not be more restrictive than the most common tool that it's trying to emulate. In the case of distributing RPMs, that tool is createrepo_c.

So, for this task, we need to document the RPM encoding policy, cite sources, and provide examples. As far as where the documentation can live, I think it would be fine somewhere in the RPM plugin's docs, such as the technical reference section: http://docs.pulpproject.org/plugins/pulp_rpm/tech-reference/index.html