Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Open
stevepiercy opened this issue Jun 2, 2016 · 3 comments
Open

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

stevepiercy opened this issue Jun 2, 2016 · 3 comments
Labels

Comments

@stevepiercy
Copy link
Member

stevepiercy commented Jun 2, 2016

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,

@crooksey
Copy link

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

@stevepiercy
Copy link
Member Author

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.
Pylons/pylonsproject.org#7

@stevepiercy
Copy link
Member Author

See #2634 and #2614

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

2 participants