search

Pylons / pastedeploy

provides code to load WSGI applications and servers from URIs
MIT License
23 stars 13 forks source link

docs need to be republished #4

Closed cdent closed 5 years ago

cdent commented 5 years ago

The current docs at https://pastedeploy.readthedocs.io/en/latest/ are out of date and we lack access to update them. We'd like to republish them elsewhere.

see https://github.com/Pylons/pyramid/issues/3425#issuecomment-440769638 with:

I think the best solution here would be to bring PasteDeploy under the pylons project and we'll give it a url in the docs.pylonsproject.org namespace

mmerickel commented 5 years ago

https://readthedocs.org/projects/pylons-pastedeploy/ is setup with access given to everyone who should need it and they are rendering at https://docs.pylonsproject.org/projects/pastedeploy/en/latest/. RTD has a pretty minimal config so far.

@stevepiercy is really good at dealing with the docs if we want to adopt the pylons sphinx theme and flesh that out. Thoughts?

stevepiercy commented 5 years ago

I'm happy to contribute.

Both Sphinx themes support Ethical Ads, which generate revenue that is currently split between RTD and the PSF.

Using the Pylons theme would establish a brand and identity of the Pylons Project.

The Pylons theme is not responsive. Example: https://docs.pylonsproject.org/projects/docs-style-guide/. Some day, there will be responsive themes for pylons-sphinx-theme. It's been long in the planning, just never executed.

cdent commented 5 years ago

Sounds like a plan.

cdent commented 5 years ago

We'll want to update the README and setup.py to point to the new location for the docs.

stevepiercy commented 5 years ago

Should I keep the theme as is or use the Pylons Sphinx theme?

cdent commented 5 years ago

Whatever seems best/easiest to you.

stevepiercy commented 5 years ago

Closed by #14