From 27f8bb91a6cfe0ec82736afc7714d66ec8c8b829 Mon Sep 17 00:00:00 2001 From: John McDole Date: Mon, 13 Jan 2025 11:03:50 -0800 Subject: [PATCH] Udpate documentation on the third_party directories (#161407) Fixes #161336 --- docs/contributing/Style-guide-for-Flutter-repo.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/contributing/Style-guide-for-Flutter-repo.md b/docs/contributing/Style-guide-for-Flutter-repo.md index 934db38719f..06120dfb0aa 100644 --- a/docs/contributing/Style-guide-for-Flutter-repo.md +++ b/docs/contributing/Style-guide-for-Flutter-repo.md @@ -361,7 +361,12 @@ widget for that rather than updating the existing buttons to have the new style. All code in all Flutter repositories must be contributed by developers who have signed [the Google CLA](https://cla.developers.google.com/), and must be licensed using our normal BSD license with a copyright referencing "The Flutter Authors", except if it is "third party code". -"Third party code" that is not part of a Dart package must be in a subdirectory of a `third_party` directory at the root of the relevant repository, and the subdirectory in question must contain a `LICENSE` file that details the license covering that code and a `README` describing the provenance of that code. +"Third party code" that is not part of a Dart package must be in a subdirectory of a `third_party` directory located: + +* [/third_party](../../third_party) for the Flutter Framework +* [/engine/src/flutter/third_party](../../engine/src/flutter/third_party) for the Flutter Engine. + +The subdirectory in question must contain a `LICENSE` file that details the license covering that code and a `README` describing the provenance of that code. "Third party code" that is part of a Dart package and is not Dart code must be in a subdirectory of a `third_party` directory at the root of the package, and the subdirectory in question must contain a `LICENSE` file that details the license covering that code and a `README` describing the provenance of that code. The license must then also be duplicated into the package's `LICENSE` file using the syntax described in the [LicenseRegistry](https://master-api.flutter.dev/flutter/foundation/LicenseRegistry-class.html) API docs. @@ -371,7 +376,7 @@ All licenses included in this manner must have been reviewed and determined to b All such "third party code" must either be a fork for which we take full responsibility, or there must be an automated rolling mechanism that keeps the code up to date when the upstream source changes. -In general it is _strongly_ recommended that we avoid any such code unless strictly necessary. +In general it is _strongly_ recommended that we avoid any such code unless strictly necessary. In particular, we aim for all _Flutter Framework_ code in the flutter/flutter repository to be single-licensed. ## Documentation (dartdocs, javadocs, etc)