the extending page is wildly out of date

[mmerickel]

specifically "Making Good Development Environments" at https://trypyramid.com/extending-pyramid.html

• uses pcreate
• uses paste instead of waitress
• recommends weberror
• recommends repoze.tm
• recommends a pipeline configuration
• bad linting around entry_points = """ due to spaces in a dict item
• doesn't explain {{project}} vs {{package}}
• misuses {{project}} in [app:{{project}}]

[kpinc]

Consider also::

host=127.0.0.1

instead of::

host=0.0.0.0

Who knows who is going to install what on what box and inadvertently expose pserve, and whatever's behind it, to the Internet with just HTTP.

[stevepiercy]

@mmerickel do you mean replace this stuff with cookiecutter stuff? I assume so, but don't want to start on this without a direction to follow.

[mmerickel]

These sections should be removed and just link to some locations in the pyramid docs (which may not exist yet). They are not maintainable here which is the reason they are suggesting several things that are almost a decade out of date.

[stevepiercy]

@mmerickel means these pages in the Pyramid docs:

• Pyramid cookiecutters: Update content for how to write a cookiecutter following scaffolds' example.
• Create a new page for Making good add-ons.
• Create a new page for Making Good Development Environments