pyramid icon indicating copy to clipboard operation
pyramid copied to clipboard

Docs Index is too wall-of-texty, loses Pyramid Introduction

Open stevepiercy opened this issue 8 years ago • 3 comments

The Pyramid Introduction is lost in the wall of text, listed as the first page under Narrative Documentation. We have previously shuffled and re-shuffled sections around, but the constraint of the current Sphinx theme and its layout makes this difficult to solve. We also duplicate content that now exists on trypyramid.com that should not be here as we have already sold the user to use Pyramid.

We need to promote "Pyramid Introduction" to be more prominent on the main page, implementation TBD, possibly after I finish the new Pyramid Sphinx theme. TryPyramid.com already does this well on its home page:

Developers may dive in to Pyramid's narrative documentation,

stevepiercy avatar Jun 02 '16 20:06 stevepiercy

Should we also not (if changing this) redirect http://www.pylonsproject.org/ to trypyramid.com.

As if a new user was to google pyramid framework, they are taken to pylonsproject.org, we cannot assume all users have seen trypyramid.com

Then the documentation index could simply start from below Narrative Documentation (from http://docs.pylonsproject.org/projects/pyramid/en/latest/index.html):

Narrative Documentation

Narrative documentation in chapter form explaining how to use Pyramid.

Pyramid Introduction

crooksey avatar Jun 28 '16 09:06 crooksey

pylonsproject.org shall become the marketing website of the umbrella organization Pylons Project and provide a page for each of its projects. Example: http://www.pocoo.org/projects/

Here's the proposed site structure. https://github.com/Pylons/pylonsproject.org/issues/7

stevepiercy avatar Jun 28 '16 09:06 stevepiercy

See #2634 and #2614

stevepiercy avatar Nov 26 '16 08:11 stevepiercy