dart-lang / site-www

Source for Dart website
https://dart.dev
Other
936 stars 676 forks source link

Add Dart's interop story to the documentation #4563

Open MaryaBelanger opened 1 year ago

MaryaBelanger commented 1 year ago

This issue is so I remember I want to do this, but it's not tied to any release or development work.

@sigmundch described Dart's interop story in a meeting the other day, and I think it would be nice to have a little paragraph or two about it somewhere adjacent to all the interop docs.

The progression of Dart's interop history and the goals it's moving towards are interesting in their own right, but I especially liked how it's also kind of a microcosm of the whole Dart story, i.e. that Dart started with a very specific use case in mind, but we're constantly widening that scope, becoming more applicable to more developers, and always evolving to be as sustainable and well-rounded as possible.

I don't have an idea about exactly what I want to say yet, but these are some notes:

I like the idea making a top-level interop page, where we can introduce Dart+interop generally, that umbrellas all the existing, more specific interop content. For example, in the left nav, if "Interoperability" was an actual page and not just a nav heading. image (Where it goes and the "umbrella topic page" concept will make more sense with the upcoming site restructure)


Linking to #5439

parlough commented 5 months ago

@MaryaBelanger Do you mind if we reposition this issue as a subtask or follow-up of https://github.com/dart-lang/site-www/issues/5439?

That way this issue can be more about the story and historical aspects, which don't necessarily have to be part of the initial version of the new overview page?

Note I love this idea and your discussion of it above!

MaryaBelanger commented 5 months ago

@parlough Yeah definitely, thanks for figuring out how this fits in!