Closed stevepiercy closed 9 years ago
I agree that the tutorials in general need a complete housecleaning. In general, our stance has been that these tutorials are a community project, not core documentation. As such, if someone contributes a tutorial that then gets out of date, well, that happens in open source. Of course, since the tutorial in question is mine...[wink]
I don't quite know the deprecation policy for Pyramid docs vis a vis broken links. Do we just put a banner on all the pages saying it is out of date and leave it in place? Do we delete all the content and leave the page? Do we delete the pages? Do we remove the entire tutorial (which would be the ideal option)?
@pauleveritt I think the presence of the same content in two places, yet different versions, is harmful. AFAIK, no other tutorial's content is also in the official docs and two places. It's confusing to visitors and it requires additional overhead and maintenance.
In this special case, we should:
@pauleveritt Would you please review PR #92? I would like to merge it, unless you say "nope".
pyramid_tutorials/getting_started may be out of date and out of sync with the official docs. In fact, @pauleveritt should it be removed/refer to the official docs Quick Tutorial? I think it is confusing. See https://github.com/Pylons/pyramid/pull/1650