[Pulp-dev] Pulp smash test docs and issues

Brian Bouterse bbouters at redhat.com
Fri Aug 10 14:16:35 UTC 2018


On Thu, Aug 9, 2018 at 5:42 PM, Daniel Alley <dalley at redhat.com> wrote:

> I think this is fine where it is. pulp2 is going into maintenance mode at
>> some point here soon.
>
>
> That makes sense for the Pulp 2 smash test docs, but it's still a problem
> if we want to have smash test docs for Pulp 3 (which, we do)
>
That's true, we do need it to live somewhere.

The main thing I want to avoid is trying to include content from one repo,
i.e. PulpQE/pulp-smash to be published through the docs of the sphinx
project in pulp/pulp. In terms of what pulp-smash offers and how to use it,
I think that should be its own site, separate from Pulp's docs.
Additionally, I could imagine a section in our docs either recommending
pulp-smash and linking to the pulp-smash docs, and maybe expanding on its
examples some. Is this kind of what you imagined? How is it
similar/different?


> On Thu, Aug 9, 2018 at 5:12 PM, Brian Bouterse <bbouters at redhat.com>
> wrote:
>
>> Thanks for bringing this up. I put some responses inline.
>>
>> On Thu, Aug 9, 2018 at 4:22 PM, David Davis <daviddavis at redhat.com>
>> wrote:
>>
>>> One of the things that may not make sense anymore is how we document and
>>> track issues for pulp-smash tests given that these tests no longer reside
>>> in the pulp-smash repo. Currently, all the test-related issues are tracked
>>> here[0].
>>>
>>> With the tests no longer in the pulp-smash repo, I wonder if it makes
>>> sense to maybe move them somewhere else like into redmine for Pulp 3 (or
>>> the pulp-2-tests[1] repo for Pulp 2).
>>>
>> +1 to moving issues about the testing of a plugin to that plugin's tracker
>>
>>
>>> The other question is about documentation. Currently the pulp-smash test
>>> documentation is hosted on RTD (e.g. https://pulp-2-tests.rea
>>> dthedocs.io/en/latest/). Should this documentation live alongside the
>>> core/plugin docs?
>>>
>> I think this is fine where it is. pulp2 is going into maintenance mode at
>> some point here soon.
>>
>>
>>> QE would like to hear feedback as to how to proceed by August 20, 2018
>>> so please respond by then.
>>>
>>> Thanks.
>>>
>>> [0] https://github.com/pulpqe/pulp-smash/issues
>>> [1] https://github.com/PulpQE/Pulp-2-Tests
>>>
>>> David
>>>
>>> _______________________________________________
>>> Pulp-dev mailing list
>>> Pulp-dev at redhat.com
>>> https://www.redhat.com/mailman/listinfo/pulp-dev
>>>
>>>
>>
>> _______________________________________________
>> Pulp-dev mailing list
>> Pulp-dev at redhat.com
>> https://www.redhat.com/mailman/listinfo/pulp-dev
>>
>>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://listman.redhat.com/archives/pulp-dev/attachments/20180810/6a9ddf03/attachment.htm>


More information about the Pulp-dev mailing list