On Wed, Jun 01, 2016 at 11:23:58AM -0400, Kartikaya Gupta wrote:
On Wed, Jun 1, 2016 at 10:06 AM, Mike Hoye <mh...@mozilla.com> wrote:
On 2016-06-01 5:02 AM, L. David Baron wrote:
So I tend to think it's worth keeping, but with a preface that clearly labels it as historical and no longer good practice, and perhaps with an appendix pointing to the current practices.

Hey, Sheppy - Should we make a practice of stripping anchor links from historical/outdated/archived documentation? On a few occasions I've had links drop me into the middle of a document, skipping over the big red warning at the top saying "this is old, don't do any of this". I might be alone in this, but I suspect I'm not the only person who's lost time because of it.

Or make the warning a fixed-position item, so it's on-screen
regardless of where on the page you are.

+1 I've been bitten by this more than once.

I think that archiving the page is a good solution, though. Archived content has a different background color, and a striped border around all of the article content, so it's not easy to miss.
_______________________________________________
dev-platform mailing list
dev-platform@lists.mozilla.org
https://lists.mozilla.org/listinfo/dev-platform

Reply via email to