[Pulp-dev] sphinx theme for docs.pulpproject.org

[Quirin Pamp]

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 <ipanova at redhat.com>
Sent: 01 October 2020 15:00
To: Dennis Kliban <dkliban at redhat.com>
Cc: Quirin Pamp <pamp at atix.de>; Pulp-dev <pulp-dev at 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 <dkliban at redhat.com<mailto:dkliban at redhat.com>> wrote:
On Thu, Sep 24, 2020 at 9:01 AM Quirin Pamp <pamp at atix.de<mailto:pamp at 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-bounces at redhat.com<mailto:pulp-dev-bounces at redhat.com> <pulp-dev-bounces at redhat.com<mailto:pulp-dev-bounces at redhat.com>> on behalf of Dennis Kliban <dkliban at redhat.com<mailto:dkliban at redhat.com>>
Sent: 24 September 2020 14:47
To: Pulp-dev <pulp-dev at redhat.com<mailto:pulp-dev at 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 at redhat.com<mailto: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/20201001/6e4f6632/attachment.htm>