Add deeplink-guide.md

[claraf3]

Guide that summarizes the content for basic and advanced deep link recipe

[gemini-code-assist]

Summary of Changes

Hello @claraf3, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request introduces a new documentation guide that provides a comprehensive explanation of deep link handling within the Navigation 3 framework. It covers the essential steps for converting incoming deep link intents into navigation keys and outlines strategies for managing the back stack to ensure a consistent and intuitive user navigation experience, particularly when dealing with different task launch scenarios.

Highlights

• New Deep Link Guide: A new documentation file, deeplink-guide.md, has been added to provide comprehensive guidance on handling deep links with Navigation 3.
• Intent Parsing to NavKey: The guide details a four-step process for parsing incoming deep link intents into NavKey objects, including defining DeepLinkPatterns, parsing requests, matching patterns, and decoding to keys, with a Kotlin example leveraging kotlinx.serialization.
• Synthetic Back Stack Management: It explains how to build and manage a synthetic back stack to ensure proper 'Back' and 'Up' navigation behavior for deep links, differentiating between existing and new task scenarios.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

This pull request adds a comprehensive guide for handling deep links. The document is well-structured and covers both basic parsing and advanced back stack management. I've made a few suggestions to improve consistency and fix a broken link in the documentation.

[gemini-code-assist]

There seems to be a typo in the filename for the deep link recipe. The link points to BDEEPLINKREADME.md, but based on the project structure, it should likely be README.md. This results in a broken link.

Suggested change

	For more details, refer to the [Basic Deep Link Recipe](../app/src/main/java/com/example/nav3recipes/deeplink/basic/BDEEPLINKREADME.md)
	For more details, refer to the [Basic Deep Link Recipe](../app/src/main/java/com/example/nav3recipes/deeplink/basic/README.md)

[claraf3]

Merged this into advanced deeplink pr