Skip to content

[Future] Move away from documenting "null safety" as its own entity #4603

Open
@parlough

Description

Currently we have a lot of documentation covering null safety as both an integrated and an isolated concept, but it really is just a part of the type system. In the longer term (far post Dart 3) "null safety" as a term likely shouldn't be super common on the site, but instead be incorporated naturally across the entire documentation, particularly updated type and type systems sections.

Prerequisites:

Some steps:

  • Consider a new nullable type section or subsection to new language docs
  • Verify nullable and non-nullable types are covered and used as necessary across all docs on the site
  • Introduce specific or better examples in cheatsheets and/or codelabs around nullable types
  • Update or rewrite type system article to be more thorough in nullable and non-nullable types (Understanding null safety has great related content)

Way later steps:

  • Remove all mentions of unsound null safety (--no-sound-null-safety)
  • Remove or archive articles about enabling and configuring null safety

Metadata

Assignees

No one assigned

    Labels

    dev.null-safetyRelates to transforming or migrating Dart code to sound null safetydev.type-systemRelates to the type system in Darte4-monthsCan complete in >= 1 month of normal, not dedicated, workfrom.teamReported by Dash docs team memberp3-lowValid but not urgent concern. Resolve when possible. Encourage upvote to surface.st.blockedIssue cannot continue until another action completesst.triage.ltwIndicates Lead Tech Writer has triaged

    Type

    No type

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions