Of course these options are not mutually exclusive. We could decide on some 
theme (e.g.: pulp_ansible theme) and then have both pulpcore and all plugins 
consistently use that theme.
I do quite like the sphinx_rtd_theme used by pulpcore, but that may just be 
because I am used to it.

I guess my personal preferences would be:

1) All plugins and pulpcore use a custom pulp theme with pulp logo and a colour 
scheme like the one on https://pulpproject.org/
2) All plugins and pulpcore simply use the sphinx_rtd_theme (which strikes me 
as good enough, already widely in use, and similar to what readthedocs uses, so 
nobody needs to get used to anything totally new).
3) All plugins and pulpcore consistently use some other agreed upon theme.

In the interest of "getting on with it" I would propose going with option (2) 
right now, and setting option (1) as a long term goal (perhaps open an issue 
for it).

Kind regards,
Quirin Pamp (quba42)

________________________________
From: Ina Panova <ipan...@redhat.com>
Sent: 01 October 2020 15:00
To: Dennis Kliban <dkli...@redhat.com>
Cc: Quirin Pamp <p...@atix.de>; Pulp-dev <pulp-dev@redhat.com>
Subject: Re: [Pulp-dev] sphinx theme for docs.pulpproject.org

my preference number 1 would be making plugins consistent with pulpcore.
2nd preference would be plup_ansibe theme.

--------
Regards,

Ina Panova
Senior Software Engineer| Pulp| Red Hat Inc.

"Do not go where the path may lead,
 go instead where there is no path and leave a trail."


On Thu, Sep 24, 2020 at 4:14 PM Dennis Kliban 
<dkli...@redhat.com<mailto:dkli...@redhat.com>> wrote:
On Thu, Sep 24, 2020 at 9:01 AM Quirin Pamp <p...@atix.de<mailto:p...@atix.de>> 
wrote:
I don't have a strong opinion, but I feel like if we don't come up with 
anything better we could just  fall back to what the pulpcore docs are 
currently using.

https://docs.pulpproject.org/pulpcore/
https://github.com/pulp/pulpcore/blob/d31eb22453cd2d56b43ed884ec193fa166cafe62/docs/conf.py#L116


+1 to making everything consistent with pulpcore.

quba42
________________________________
From: pulp-dev-boun...@redhat.com<mailto:pulp-dev-boun...@redhat.com> 
<pulp-dev-boun...@redhat.com<mailto:pulp-dev-boun...@redhat.com>> on behalf of 
Dennis Kliban <dkli...@redhat.com<mailto:dkli...@redhat.com>>
Sent: 24 September 2020 14:47
To: Pulp-dev <pulp-dev@redhat.com<mailto:pulp-dev@redhat.com>>
Subject: [Pulp-dev] sphinx theme for 
docs.pulpproject.org<http://docs.pulpproject.org>

We are slowly rolling out plugin docs to 
docs.pulpproject.org<http://docs.pulpproject.org>. At this time pulp_file and 
pulp_ansible are the only plugins publishing their docs there. What I noticed 
is that they have completely different themes. We need to pick a single theme 
to be used by all plugins. Does anyone have suggestions for which theme that 
should be?

https://docs.pulpproject.org/pulp_ansible/
https://docs.pulpproject.org/pulp_file/
_______________________________________________
Pulp-dev mailing list
Pulp-dev@redhat.com<mailto:Pulp-dev@redhat.com>
https://www.redhat.com/mailman/listinfo/pulp-dev
_______________________________________________
Pulp-dev mailing list
Pulp-dev@redhat.com
https://www.redhat.com/mailman/listinfo/pulp-dev

Reply via email to