Skip to content

Improve discoverability with feature/topic tags, e.g. records #156

Description

@youngledo

Hi, thanks for building java.evolved. The side-by-side format is very useful.

One thing I noticed while using the site is that some Java features are hard to discover as a group because their related examples can be spread across different categories.

For example, record-related patterns can show up in several contexts:

  • basic record usage
  • compact constructors and validation
  • record-based error/result types
  • records combined with pattern matching or sealed hierarchies
  • records used in data-transfer or modeling examples

The current category structure is helpful, but when I want to learn or review one language feature end-to-end, I need to search around instead of browsing a focused collection.

Would it make sense to add a secondary organization layer, such as feature/topic tags?

Possible approaches:

  • add tags like records, sealed-classes, pattern-matching, switch, streams, etc. to snippets
  • show those tags on snippet cards and search results
  • add topic pages such as /topics/records that collect related snippets across categories
  • keep the current categories as the primary structure, so this does not require duplicating content

For example, a “Records” topic page could list all record-related snippets across Language, Errors, Enterprise, or other categories, optionally ordered by Java version.

This would make the site easier to use both as a reference and as a learning path for specific Java features.

Metadata

Metadata

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions