IssueTracker

There appears to be guidance on this in the Pass data between destinations guide, but the guide's organization and title make it hard to tell what the guide is about, and therefore the guidance is unintuitive to find.

That code snippet isn't sufficient as it tells you how to pass data to a new destination when that parameter is always required. Also, it tells you how to do it using a bundle which isn't a valid approach when using the Kotlin DSL.

val bundle = bundleOf("amount" to amount) which is used in the guide would match a route like the following: "myscreen/{amount}".

In this FR, we're talking about optional parameters. So imagine a route like: "myscreen/{amount}?taskId={taskId}" that could take (or not) that taskId as parameter. Depending on whether or not taskId is null, you'd need different routes, either "myscreen/100" or "myscreen/100?taskId=123123.To navigate, you'd need to write some code like the following:

fun navigateToMyScreen(amount: String, taskId: String?) {
    navController.navigate("myscreen/{amount}").let {
        if (taskId != null) "$it?taskId=$taskId" else it
    }
}