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

Make obsolete documents more obviously obsolete #8342

Open
1 task done
martinthomson opened this issue Dec 18, 2024 · 7 comments
Open
1 task done

Make obsolete documents more obviously obsolete #8342

martinthomson opened this issue Dec 18, 2024 · 7 comments
Labels
enhancement New feature or request

Comments

@martinthomson
Copy link
Contributor

Description

See https://mailarchive.ietf.org/arch/msg/last-call/P6HaBJHlv1lvL6dUJbXCmA7Bb3o for context.

Consider the obsolete RFC 793 and its presentation on datatracker: https://datatracker.ietf.org/doc/html/rfc793 and https://datatracker.ietf.org/doc/rfc793/

Both of these show the document as an "Internet Standard" in the most prominent (and green-colored) position. You have to dig a little more to realize that this is obsolete.

Though the mail thread contemplates formally adding an "obsolete" status for documents, there are UX improvements that could make that condition more prominent, so that people spend less time thinking that an obsolete document is current and valid.

I'm not going to do UX design here, as much as I'd like to, but I think that some small changes to the presentations would help a great deal.

Code of Conduct

@martinthomson martinthomson added the enhancement New feature or request label Dec 18, 2024
@becarpenter
Copy link

I support such an enhancement, and without impinging too much on UX myself, simply displaying "OBSOLETE INTERNET STANDARD" or "OBSOLETE PROPOSED STANDARD" etc. wherever appropriate would help a lot. "OBSOLETE INFORMATIONAL" wouldn't harm, either.

@cabo
Copy link
Collaborator

cabo commented Dec 18, 2024 via email

@martinthomson
Copy link
Contributor Author

Fine, "OUTDATED VERSION (see RFC $REPLACEMENT)"

Though if I were to be pedantic (it's not a competition) the document is indeed obsolete, even if the technology isn't.

@cabo
Copy link
Collaborator

cabo commented Dec 18, 2024

Fine, "OUTDATED VERSION (see RFC $REPLACEMENT)"

WFM (although it perpetuates the use of my pet non-term, "version").

Though if I were to be pedantic (it's not a competition) the document is indeed obsolete, even if the technology isn't.

Yes. The problem is this linguistic device called "pars pro toto", in where we use a part of something (Washington) to refer to the whole thing (US of A). "RFC 793 is obsolete" means "the document RFC 793 is obsolete" as much as it means "TCP the technology, which is described in RFC 793 so we use this as its pars pro toto handle, is obsolete". Clearly, RFC 5246 is obsolete in both ways, so this interpretation wouldn't be entirely mistaken.

@OR13
Copy link

OR13 commented Dec 18, 2024

Proposal:

Image

Image

Badging should be used consistently, knowing that something is obsoleted is also possibly more important than knowing that it has errata, the order here should probably be errata second and not first... I would also make errata yellow and obsoleted red.

@paulwouters
Copy link

I am in favour of clearly marking the obsoleteness beyond just the one coloured tag.

@becarpenter
Copy link

Back to @cabo's comment, REPLACED INTERNET STANDARD seems better overall. There is indeed a semantic difference between replacing a standard and obsoleting it. And if you imagine "Replaced" where @or18 has "Obsoleted" it works fine.

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

No branches or pull requests

5 participants