diff --git a/README.md b/README.md
index cd76430c..993e3828 100644
--- a/README.md
+++ b/README.md
@@ -1,208 +1,22 @@
# Flutter Location Plugin
-[](https://pub.dartlang.org/packages/location) 
-[](https://codecov.io/gh/Lyokone/flutterlocation)
+This repository contains the following packages:
-This plugin for [Flutter](https://flutter.io)
-handles getting a location on Android and iOS. It also provides callbacks when the location is changed.
-
-
-
- 
-
-
-
-[Web demo](https://lyokone.github.io/flutterlocation) (more features available on Android/iOS)
+- [`location`][location]: code for the cross-platform facing plugin used to
+ display local notifications within Flutter applications. This is what you use
+ in your app!
+- [`location_platform_interface`][location_platform_interface]: plugin's common
+ platform interface code
+- [`location_web`][location_web]: the Web implementation of the plugin
## Getting Started
-Add this to your package's `pubspec.yaml` file:
-
-```yaml
-dependencies:
- location: ^4.2.0
-```
-
-### Android
-
-With Flutter 1.12, all the dependencies are automatically added to your project.
-If your project was created before Flutter 1.12, you might need to follow [this](https://github.com/flutter/flutter/wiki/Upgrading-pre-1.12-Android-projects).
-
-To use location background mode on Android, you have to use the enableBackgroundMode({bool enable}) API before accessing location in the background and adding necessary permissions. You should place the required permissions in your applications /android/app/src/main/AndroidManifest.xml:
-
-```xml
-
-
-```
-
-Remember that the user has to accept the location permission to `always allow` to use the background location. The Android 11 option to `always allow` is not presented on the location permission dialog prompt. The user has to enable it manually from the app settings. This should be explained to the user on a separate UI that redirects the user to the app's location settings managed by the operating system. More on that topic can be found on [Android developer](https://developer.android.com/training/location/permissions#request-background-location) pages.
-
-### iOS
-
-And to use it in iOS, you have to add this permission in Info.plist :
-
-```
-// This is probably the only one you need. Background location is supported
-// by this -- the caveat is that a blue badge is shown in the status bar
-// when the app is using location service while in the background.
-NSLocationWhenInUseUsageDescription
-
-// Deprecated, use NSLocationAlwaysAndWhenInUseUsageDescription instead.
-NSLocationAlwaysUsageDescription
-
-// Use this very carefully. This key is required only if your iOS app
-// uses APIs that access the user’s location information at all times,
-// even if the app isn't running.
-NSLocationAlwaysAndWhenInUseUsageDescription
-```
-
-To receive location when application is in background, to Info.plist you have to add property list key :
-
-```xml
-UIBackgroundModes
-```
-
-with string value:
-
-```xml
-location
-```
-
-### Web
-
-Nothing to do, the plugin works directly out of box.
-
-### macOS
-
-Ensure that the application is properly "sandboxed" and that the location is enabled. You can do this in Xcode with the following steps:
-
-1. In the project navigator, click on your application's target. This should bring up a view with tabs such as "General", "Capabilities", "Resource Tags", etc.
-1. Click on the "Capabilities" tab. This will give you a list of items such as "App Groups", "App Sandbox", and so on. Each item will have an "On/Off" button.
-1. Turn on the "App Sandbox" item and press the ">" button on the left to show the sandbox stuff.
-1. In the "App Data" section, select "Location".
-
-Add this permission in Info.plist :
-
-```xml
-NSLocationWhenInUseUsageDescription
-NSLocationAlwaysUsageDescription
-```
-
-## Usage
-
-Then you just have to import the package with
-
-```dart
-import 'package:location/location.dart';
-```
-
-In order to request location, you should always check Location Service status and Permission status manually
-
-```dart
-Location location = new Location();
-
-bool _serviceEnabled;
-PermissionStatus _permissionGranted;
-LocationData _locationData;
-
-_serviceEnabled = await location.serviceEnabled();
-if (!_serviceEnabled) {
- _serviceEnabled = await location.requestService();
- if (!_serviceEnabled) {
- return;
- }
-}
-
-_permissionGranted = await location.hasPermission();
-if (_permissionGranted == PermissionStatus.denied) {
- _permissionGranted = await location.requestPermission();
- if (_permissionGranted != PermissionStatus.granted) {
- return;
- }
-}
-
-_locationData = await location.getLocation();
-```
-
-You can also get continuous callbacks when your position is changing:
-
-```dart
-location.onLocationChanged.listen((LocationData currentLocation) {
- // Use current location
-});
-```
-
-To receive location when application is in background you have to enable it:
-
-```dart
-location.enableBackgroundMode(enable: true)
-```
-
-Be sure to check the example project to get other code samples.
-
-On Android, a foreground notification is displayed with information that location service is running in the background.
-
-On iOS, while the app is in the background and gets the location, the blue system bar notifies users about updates. Tapping on this bar moves the User back to the app.
-
-
- 
- 
-
-
-## Public Methods Summary
-
-| Return | Description |
-| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| Future\ | **requestPermission()**
Request the Location permission. Return a PermissionStatus to know if the permission has been granted. |
-| Future\ | **hasPermission()**
Return a PermissionStatus to know the state of the location permission. |
-| Future\ | **serviceEnabled()**
Return a boolean to know if the Location Service is enabled or if the user manually deactivated it. |
-| Future\ | **requestService()**
Show an alert dialog to request the user to activate the Location Service. On iOS, will only display an alert due to Apple Guidelines, the user having to manually go to Settings. Return a boolean to know if the Location Service has been activated (always `false` on iOS). |
-| Future\ | **changeSettings(LocationAccuracy accuracy = LocationAccuracy.HIGH, int interval = 1000, double distanceFilter = 0)**
Will change the settings of futur requests. `accuracy`will describe the accuracy of the request (see the LocationAccuracy object). `interval` will set the desired interval for active location updates, in milliseconds (only affects Android). `distanceFilter` set the minimum displacement between location updates in meters. |
-| Future\ | **getLocation()**
Allow to get a one time position of the user. It will try to request permission if not granted yet and will throw a `PERMISSION_DENIED` error code if permission still not granted. |
-| Stream\ | **onLocationChanged**
Get the stream of the user's location. It will try to request permission if not granted yet and will throw a `PERMISSION_DENIED` error code if permission still not granted. |
-| Future\ | **enableBackgroundMode({bool enable})**
Allow or disallow to retrieve location events in the background. Return a boolean to know if background mode was successfully enabled. |
-
-You should try to manage permission manually with `requestPermission()` to avoid error, but plugin will try handle some cases for you.
-
-## Objects
-
-```dart
-class LocationData {
- final double latitude; // Latitude, in degrees
- final double longitude; // Longitude, in degrees
- final double accuracy; // Estimated horizontal accuracy of this location, radial, in meters
- final double altitude; // In meters above the WGS 84 reference ellipsoid
- final double speed; // In meters/second
- final double speedAccuracy; // In meters/second, always 0 on iOS
- final double heading; // Heading is the horizontal direction of travel of this device, in degrees
- final double time; // timestamp of the LocationData
- final bool isMock; // Is the location currently mocked
-}
-
-
-enum LocationAccuracy {
- powerSave, // To request best accuracy possible with zero additional power consumption,
- low, // To request "city" level accuracy
- balanced, // To request "block" level accuracy
- high, // To request the most accurate locations available
- navigation // To request location for navigation usage (affect only iOS)
-}
-
-// Status of a permission request to use location services.
-enum PermissionStatus {
- /// The permission to use location services has been granted.
- granted,
- // The permission to use location services has been denied by the user. May have been denied forever on iOS.
- denied,
- // The permission to use location services has been denied forever by the user. No dialog will be displayed on permission request.
- deniedForever
-}
-
-```
-
-Note: you can convert the timestamp into a `DateTime` with: `DateTime.fromMillisecondsSinceEpoch(locationData.time.toInt())`
+Head over to the [documentation website].
-## Feedback
+The full README for the plugin can be found in the [location] directory, or on
+[pub.dev](https://pub.dev/packages/location).
-Please feel free to [give me any feedback](https://github.com/Lyokone/flutterlocation/issues)
-helping support this plugin !
+[location]: https://github.com/Lyokone/flutterlocation/tree/master/packages/location
+[location_platform_interface]: https://github.com/Lyokone/flutterlocation/tree/master/packages/location_platform_interface
+[location_web]: https://github.com/Lyokone/flutterlocation/tree/master/packages/location_web
+[documentation website]: https://docs.page/Lyokone/flutterlocation
diff --git a/packages/location/CHANGELOG.md b/packages/location/CHANGELOG.md
index 9e8f8cc2..c7242d3b 100644
--- a/packages/location/CHANGELOG.md
+++ b/packages/location/CHANGELOG.md
@@ -1,4 +1,10 @@
-## 5.0.2
+## 5.0.2+1
+
+- Clean up README (#874)
+ - Fix broken links in the README of `location` package
+ - Remove most of the duplicated info from repo's top-level README
+
+## 5.0.2+1
- Bump dependency on `location_platform_interface` to `^3.1.1`
- Bump dependency on `location_web` to `^4.1.1`
diff --git a/packages/location/README.md b/packages/location/README.md
index 5d5905d8..52e60bb0 100644
--- a/packages/location/README.md
+++ b/packages/location/README.md
@@ -1,9 +1,9 @@
# location
-[![patrol on pub.dev][patrol_badge]][patrol_link]
+[![location on pub.dev][location_badge]][location_link]
[![code style][leancode_lint_badge]][leancode_lint_link]
[![powered by][docs_page_badge]][docs_page_link]
-[](https://codecov.io/gh/Lyokone/flutterlocation)
+[![codecov][codecov_badge]][codecov_link]
This plugin for [Flutter](https://flutter.dev)
handles getting a location on Android and iOS. It also provides callbacks when the location is changed.
@@ -211,3 +211,5 @@ helping support this plugin !
[leancode_lint_link]: https://pub.dev/packages/leancode_lint
[docs_page_badge]: https://img.shields.io/badge/documentation-docs.page-34C4AC.svg?style
[docs_page_link]: https://docs.page
+[codecov_badge]: https://codecov.io/gh/Lyokone/flutterlocation/branch/master/graph/badge.svg
+[codecov_link]: https://codecov.io/gh/Lyokone/flutterlocation
diff --git a/packages/location/pubspec.yaml b/packages/location/pubspec.yaml
index 740760a8..69f450c8 100644
--- a/packages/location/pubspec.yaml
+++ b/packages/location/pubspec.yaml
@@ -1,6 +1,6 @@
name: location
description: Cross-platform plugin for easy access to device's location in real-time.
-version: 5.0.2
+version: 5.0.2+1
homepage: https://docs.page/Lyokone/flutterlocation
repository: https://github.com/Lyokone/flutterlocation
issue_tracker: https://github.com/Lyokone/flutterlocation/issues
diff --git a/packages/location_platform_interface/README.md b/packages/location_platform_interface/README.md
index 683f0d3d..8971bbe8 100644
--- a/packages/location_platform_interface/README.md
+++ b/packages/location_platform_interface/README.md
@@ -1,18 +1,17 @@
# location_platform_interface
-A common platform interface for the [`location`][1] plugin.
+A common platform interface for the [`location`][location] plugin.
This interface allows platform-specific implementations of the `location`
-plugin, as well as the plugin itself, to ensure they are supporting the
-same interface.
+plugin, as well as the plugin itself, to ensure they are supporting the same
+interface.
# Usage
To implement a new platform-specific implementation of `location`, extend
-[`LocationPlatform`][2] with an implementation that performs the
+[`LocationPlatform`][LocationPlatform] with an implementation that performs the
platform-specific behavior, and when you register your plugin, set the default
-`LocationPlatform` by calling
-`LocationPlatform.instance = MyLocation()`.
+`LocationPlatform` by calling `LocationPlatform.instance = MyLocation()`.
# Note on breaking changes
@@ -22,5 +21,5 @@ over breaking changes for this package.
See https://flutter.dev/go/platform-interface-breaking-changes for a discussion
on why a less-clean interface is preferable to a breaking change.
-[1]: ../location
-[2]: lib/location_platform_interface.dart
+[location]: https://pub.dev/packages/location
+[LocationPlatform]: https://github.com/Lyokone/flutterlocation/blob/master/packages/location_platform_interface/lib/location_platform_interface.dart