doc(README): several improvements

Author: rultor

README.md

@@ -1,3 +1,5 @@
+# flutter_brand_palettes
+
 <img
 src="https://user-images.githubusercontent.com/24878574/119202536-61caa380-ba67-11eb-8f29-1bfa92f28143.png"
 alt="EO-Color logo" width="176" height="82"/>
@@ -13,25 +15,9 @@ Rultor.com](https://www.rultor.com/b/dartoos-dev/flutter_brand_palettes)](https:
 
 [![build](https://github.com/dartoos-dev/flutter_brand_palettes/actions/workflows/build.yml/badge.svg)](https://github.com/dartoos-dev/flutter_brand_palettes/actions/)
 [![codecov](https://codecov.io/gh/dartoos-dev/flutter_brand_palettes/branch/master/graph/badge.svg?token=Hvpu48mfx1)](https://codecov.io/gh/dartoos-dev/flutter_brand_palettes)
-![CodeFactor Grade](https://img.shields.io/codefactor/grade/github/rafamizes/flutter_brand_palettes)
-[![Hits-of-Code](https://hitsofcode.com/github/dartoos-dev/flutter_brand_palettes?branch=master)](https://hitsofcode.com/github/dartoos-dev/flutter_brand_palettes/view?branch=master)
+[![CodeFactor Grade](https://img.shields.io/codefactor/grade/github/rafamizes/flutter_brand_palettes)](https://www.codefactor.io/repository/github/rafamizes/flutter_brand_palettes)
 [![style: lint](https://img.shields.io/badge/style-lint-4BC0F5.svg)](https://pub.dev/packages/lint)
-
-## Overview
-
-**Flutter Brand Palettes** is a collection of declarative and object-oriented
-classes for the color palettes of popular brands and companies.
-
-For example, to get the Instagram colors as a `List<Color>`object,
-simply declare `InstagramGrad().colors` — the 'Grad' suffix is short for
-_Gradient_.
-
-To get a single color, declare `Instagram.royalBlue().color` for Instagram
-royal blue; `Instagram.yellow().color` for Instagram yellow, and so on.
-
-In addition, each class is well-documented and fully unit-tested — this package
-has achieved 100% code coverage and goes through a CI pipeline with rigorous
-quality gates.
+[![Hits-of-Code](https://hitsofcode.com/github/dartoos-dev/flutter_brand_palettes?branch=master)](https://hitsofcode.com/github/dartoos-dev/flutter_brand_palettes/view?branch=master)
 
 ## Contents
 
@@ -41,57 +27,82 @@ quality gates.
 - [Color Gradient in action](#color-gradient-in-action)
 - [Color Gradients](#color-palettes-in-action)
 - [Demo application](#demo-application)
-- [I need the 'X' color palettes](#i-need-the-x-brand-color-palette)
+- [I need the 'X' color palettes](#i-need-the-x-color-palette)
 - [List of Color Palettes](#list-of-color-palettes-a-z)
 - [References](#hex-color-values-references)
 
+## Overview
+
+**Flutter Brand Palettes** is a collection of declarative, object-oriented
+classes for the color palettes of popular brands and companies.
+
+For example, to retrieve Instagram's colors at once, as a `List<Color>` object,
+simply declare `InstagramGrad().colors` — the 'Grad' suffix is short for
+_Gradient_.
+
+For a single color, simply select it from the brand-related color palette class.
+For example, the command `Instagram.royalBlue()` retrieves the royal blue color
+from the Instagram color palette; `Instagram.yellow()` retrieves the yellow
+color; and so on.
+
+In addition, all classes are well-documented and fully unit-tested, passing
+through a CI pipeline with rigorous quality ports.
+
 ## Getting Started
 
 Instead of a constant integer value, a color is represented by a named
 constructor of its corresponding brand class. In this way, the source code
-becomes more object-oriented, readable and maintainable. For instance, the
-command `Instagram.red().color` retrieves the Instagram red color _#FD1D1D_;
-`Google.red().color`, the Google red _#DB4437_; `Facebook.blue().color`,
-the Facebook blue _#4267B2_, and so on.
+becomes more object-oriented, readable and maintainable.
+
+For example, the command `Facebook.blue().color` returns Facebook's blue color
+_#4267B2_. Likewise, the command `Instagram.red().color` returns Instagram's red
+color _#FD1D1D_; `Google.red().color`, Google's red color _#DB4437_.
 
 ## Color Palettes in Action
 
+The code bellow builds a container widget whose background color is Facebook
+blue.
+
 ```dart
 import 'package:brand_colors/flutter_brand_colors.dart';
 import 'package:flutter/material.dart';
 
 class FacebookIsh extends StatelessWidget {
 
+  const _blue = Facebook.blue();
+
   @override
-  Widget build(BuildContext context) {
-    return Container(
-      color: Facebook.blue().color,
-    );
-  }
+  Widget build(BuildContext context) => Container(color: _blue.color);
 }
 ```
 
 ## Color Gradient in Action
 
+The code below builds a rectangle filled with the Google logo gradient.
+
 ```dart
 
 /// Rectangle filled with Google logo color gradient.
 class Googleish extends StatelessWidget {
 
+  static final _googleGrad = const GoogleGrad().colors;
+
   @override
   Widget build(BuildContext context) {
     return Container(
-      height: kToolbarHeight / 2,
       decoration: BoxDecoration(
-        gradient: LinearGradient(
-          colors: GoogleGrad().colors,
-        ),
+        gradient: LinearGradient(colors: _googleGrad),
       ),
     );
   }
+}
 
 ```
 
+The result of the previous code in full screen
+
+![google_grad_full_screen](https://user-images.githubusercontent.com/24878574/126880793-2e9170a1-3eaa-4770-9e89-410c7e123503.png)
+
 ## Demo application
 
 The demo application provides a fully working example, focused on demonstrating
@@ -111,15 +122,17 @@ This should launch the demo application on Chrome in debug mode.
 
 ![Demo-App](https://user-images.githubusercontent.com/24878574/122657224-de6ca280-d137-11eb-9eb1-fc5169872d64.png)
 
-## I need the 'X' brand color palette
+## I need the 'X' color palette
 
-Do you need any brand that has not yet been implemented?
+Do you need a color palette that has not been implemented yet?
 
-It doesn't matter the size and relevance of the company, not even if it's a
-tech company.
+It doesn't matter the size and relevance of the company, not even if it's a tech
+company.
 
-Just open an [issue](https://github.com/dartoos-dev/flutter_brand_palettes/issues)
-and enter the brand or company name — the colors will be implemented as soon as possible. 
+Just open an
+[issue](https://github.com/dartoos-dev/flutter_brand_palettes/issues) and enter
+the brand or company name; the color palette will be implemented as soon as
+possible.
 
 ## List of Color Palettes (A-Z)
 

example/lib/main.dart

@@ -1,6 +1,6 @@
+import 'package:eo_color/eo_color.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter_brand_palettes/flutter_brand_palettes.dart';
-import 'package:eo_color/eo_color.dart';
 
 void main() => runApp(MyApp());
 

example/pubspec.lock

@@ -7,7 +7,7 @@ packages:
       name: async
       url: "https://pub.dartlang.org"
     source: hosted
-    version: "2.6.1"
+    version: "2.7.0"
   boolean_selector:
     dependency: transitive
     description:
@@ -49,7 +49,7 @@ packages:
       name: eo_color
       url: "https://pub.dartlang.org"
     source: hosted
-    version: "1.1.3"
+    version: "1.1.5"
   fake_async:
     dependency: transitive
     description:
@@ -68,7 +68,7 @@ packages:
       path: ".."
       relative: true
     source: path
-    version: "0.3.6"
+    version: "0.3.8"
   flutter_test:
     dependency: "direct dev"
     description: flutter
@@ -94,7 +94,7 @@ packages:
       name: meta
       url: "https://pub.dartlang.org"
     source: hosted
-    version: "1.3.0"
+    version: "1.4.0"
   path:
     dependency: transitive
     description:
@@ -148,7 +148,7 @@ packages:
       name: test_api
       url: "https://pub.dartlang.org"
     source: hosted
-    version: "0.3.0"
+    version: "0.4.0"
   typed_data:
     dependency: transitive
     description:

example/pubspec.yaml

@@ -9,7 +9,7 @@ environment:
   sdk: ">=2.12.0 <3.0.0"
 
 dependencies:
-  eo_color: ^1.1.3
+  eo_color: ^1.1.5
   flutter:
     sdk: flutter
 

pubspec.lock

@@ -7,7 +7,7 @@ packages:
       name: async
       url: "https://pub.dartlang.org"
     source: hosted
-    version: "2.6.1"
+    version: "2.7.0"
   boolean_selector:
     dependency: transitive
     description:
@@ -49,7 +49,7 @@ packages:
       name: eo_color
       url: "https://pub.dartlang.org"
     source: hosted
-    version: "1.1.3"
+    version: "1.1.5"
   fake_async:
     dependency: transitive
     description:
@@ -87,7 +87,7 @@ packages:
       name: meta
       url: "https://pub.dartlang.org"
     source: hosted
-    version: "1.3.0"
+    version: "1.4.0"
   path:
     dependency: transitive
     description:
@@ -141,7 +141,7 @@ packages:
       name: test_api
       url: "https://pub.dartlang.org"
     source: hosted
-    version: "0.3.0"
+    version: "0.4.0"
   typed_data:
     dependency: transitive
     description:

pubspec.yaml

@@ -1,5 +1,5 @@
 name: flutter_brand_palettes
-description: A collection of elegant and declarative classes for the color palettes of popular brands and companies.
+description: A collection of elegant, declarative classes for the color palettes of popular brands and companies.
 version: 0.3.8
 homepage: https://dartoos.dev
 repository: https://github.com/dartoos-dev/flutter_brand_palettes
@@ -9,7 +9,7 @@ environment:
   flutter: ">=1.17.0"
 
 dependencies:
-  eo_color: ^1.1.3
+  eo_color: ^1.1.5
   flutter:
     sdk: flutter