Repository: flutter
Issue: Flutter FAQ is missing documentation on Android defaultFocusHighlightEnabled behavior
Labels: platform-android,d: api docs,P2,team-android,triaged-android

### Steps to reproduce

Flutter developers have reported a green border around some of the views in their Flutter apps (https://github.com/flutter/flutter/issues/16810). This is due to the [defaultFocusHighlightEnabled](https://developer.android.com/reference/android/view/View#attr_android:defaultFocusHighlightEnabled) attribute being set to `true` and is the expected behavior.

### Expected results

 As many Flutter developers are not familiar with default Android behavior, the green border causes confusion.

### Actual results

There should be documentation explaining the default Android behavior as to avoid confusion.

### Code sample

<details open><summary>Code sample</summary>

Note: Part of resolving this issue is coming up with the code sample to provide in the documentation.

```dart
TBD
```

</details>


### Screenshots or Video

<details open>
<summary>Screenshots / Video demonstration</summary>

[Upload media here]

</details>


### Logs

<details open><summary>Logs</summary>

```console
[Paste your logs here]
```

</details>


### Flutter Doctor output

<details open><summary>Doctor output</summary>

```console
[!] Flutter (Channel stable, 3.19.5, on macOS 14.4.1 23E224 darwin-arm64, locale en)
    • Flutter version 3.19.5 on channel stable at /Users/mossman/Development/flutter-3.19.5
    ! Upstream repository https://github.com/flutter/flutter.git is not the same as FLUTTER_GIT_URL
    • FLUTTER_GIT_URL = https://github.com/mossmana/flutter.git
    • Framework revision 300451adae (2 weeks ago), 2024-03-27 21:54:07 -0500
    • Engine revision e76c956498
    • Dart version 3.3.3
    • DevTools version 2.31.1
    • If those were intentional, you can disregard the above warnings; however it is recommended to use "git" directly to perform update checks and upgrades.

[✓] Android toolchain - develop for Android devices (Android SDK version 33.0.1)
    • Android SDK at /Users/mossman/Development/android
    • Platform android-34, build-tools 33.0.1
    • ANDROID_HOME = /Users/mossman/Development/android
    • Java binary at: /Applications/Android Studio.app/Contents/jbr/Contents/Home/bin/java
    • Java version OpenJDK Runtime Environment (build 17.0.6+0-17.0.6b829.9-10027231)
    • All Android licenses accepted.

[✓] Xcode - develop for iOS and macOS (Xcode 14.3)
    • Xcode at /Applications/Xcode.app/Contents/Developer
    • Build 14E222b
    • CocoaPods version 1.15.2

[✓] Chrome - develop for the web
    • Chrome at /Applications/Google Chrome.app/Contents/MacOS/Google Chrome

[✓] Android Studio (version 2022.3)
    • Android Studio at /Applications/Android Studio.app/Contents
    • Flutter plugin can be installed from:
      🔨 https://plugins.jetbrains.com/plugin/9212-flutter
    • Dart plugin can be installed from:
      🔨 https://plugins.jetbrains.com/plugin/6351-dart
    • Java version OpenJDK Runtime Environment (build 17.0.6+0-17.0.6b829.9-10027231)

[✓] VS Code (version 1.87.2)
    • VS Code at /Applications/Visual Studio Code.app/Contents
    • Flutter extension version 3.82.0

[✓] Connected device (3 available)
    • sdk gphone64 arm64 (mobile) • emulator-5554 • android-arm64  • Android 14 (API 34) (emulator)
    • macOS (desktop)             • macos         • darwin-arm64   • macOS 14.4.1 23E224 darwin-arm64
    • Chrome (web)                • chrome        • web-javascript • Google Chrome 123.0.6312.123

[✓] Network resources
    • All expected network resources are available.

! Doctor found issues in 1 category.

```

</details>