Fix comment references and links - all credit to @aaronlademann-wf

Author: aaronlademann-wf

example/geocodes/geocodes.dart

@@ -6,32 +6,30 @@ import 'dart:html';
 import 'package:react/react.dart' as react;
 import 'package:react/react_dom.dart' as react_dom;
 
-/**
- * Hello,
- *
- * This is the Dart portion of the tutorial for the Dart react package.
- *
- * We'll go through a simple app that queries the Google Maps API and shows the result to the user.
- * It also stores the search history and allows the user to reload past queries.
- *
- * In this file you'll find the structure and the logic of the app. There is also a `geocodes.html` file which contains
- * the mount point.
- *
- * Be sure that you understand the basic concepts of [React](http://facebook.github.io/react/) before reading this
- * tutorial.
- *
- * Enjoy!
- */
+/// Hello,
+///
+/// This is the Dart portion of the tutorial for the Dart react package.
+///
+/// We'll go through a simple app that queries the Google Maps API and shows the result to the user.
+/// It also stores the search history and allows the user to reload past queries.
+///
+/// In this file you'll find the structure and the logic of the app. There is also a `geocodes.html` file which contains
+/// the mount point.
+///
+/// Be sure that you understand the basic concepts of [React](https://reactjs.org/) before reading this
+/// tutorial.
+///
+/// Enjoy!
 
 /// Divide your app into components and conquer!
 ///
-/// This is the first custom [Component].
+/// This is the first custom `Component`.
 ///
 /// It is just an HTML `<tr>` element displaying a single API response to the user.
 class _GeocodesResultItem extends react.Component {
   /// The only function you must implement in the custom component is [render].
   ///
-  /// Every [Component] has a map of properties called [Component.props]. It can be specified during creation.
+  /// Every `Component` has a map of properties called `props`. It can be specified during creation.
   @override
   render() {
     return react.tr({}, [
@@ -42,12 +40,12 @@ class _GeocodesResultItem extends react.Component {
   }
 }
 
-/// Now we need to tell ReactJS that our custom [Component] exists by calling [registerComponent].
+/// Now we need to tell ReactJS that our custom `Component` exists by calling `registerComponent`.
 ///
 /// As a reward, it gives us a function, that takes the properties and returns our element. You'll see it in action
 /// shortly.
 ///
-/// This is the only correct way to create a [Component]. Do not use the constructor!
+/// This is the only correct way to create a `Component`. Do not use the constructor!
 var geocodesResultItem = react.registerComponent(() => _GeocodesResultItem());
 
 /// In this component we'll build an HTML `<table>` element full of the `<tr>` elements generated by
@@ -97,11 +95,11 @@ class _GeocodesResultList extends react.Component {
 
 var geocodesResultList = react.registerComponent(() => _GeocodesResultList());
 
-/// In this [Component] we'll build a search form.
+/// In this `Component` we'll build a search form.
 ///
-/// This [Component] illustrates that:
+/// This `Component` illustrates that:
 ///
-/// > The functions can be [Component] parameters _(handy for callbacks)_
+/// > The functions can be `Component` parameters _(handy for callbacks)_
 ///
 /// > The DOM [Element]s can be accessed using `ref`s.
 class _GeocodesForm extends react.Component {
@@ -216,9 +214,9 @@ class _GeocodesHistoryList extends react.Component {
 
 var geocodesHistoryList = react.registerComponent(() => _GeocodesHistoryList());
 
-/// The root [Component] of our application.
+/// The root `Component` of our application.
 ///
-/// Introduces [state]. Both [state] and [props] are valid locations to store [Component] data.
+/// Introduces [state]. Both [state] and [props] are valid locations to store `Component` data.
 ///
 /// However, there are some key differences to note:
 ///
@@ -228,7 +226,7 @@ var geocodesHistoryList = react.registerComponent(() => _GeocodesHistoryList());
 ///
 /// > When [state] is changed, the component will re-render.
 ///
-/// It's a common practice to store the application data in the [state] of the root [Component]. It will re-render
+/// It's a common practice to store the application data in the [state] of the root `Component`. It will re-render
 /// every time the state is changed. However, it is not required - you can also use normal variables and re-render
 /// manually if you wish.
 ///

example/geocodes/geocodes.html

@@ -12,7 +12,7 @@
      * In this file you'll find the mount point of the app. There is also a `geocodes.dart` file which contains the
      * structure and the application logic.
      *
-     * Be sure that you understand the basic concepts of [React](http://facebook.github.io/react/) before reading this
+     * Be sure that you understand the basic concepts of [React](https://reactjs.org/) before reading this
      * tutorial.
      *
      * Enjoy!

lib/hooks.dart

@@ -165,10 +165,10 @@ void useEffect(dynamic Function() sideEffect, [List<Object> dependencies]) {
 ///
 /// Learn more: <https://reactjs.org/docs/hooks-reference.html#usereducer>.
 class ReducerHook<TState, TAction, TInit> {
-  /// The first item of the pair returned by [React.userReducer].
+  /// The first item of the pair returned by [React.useReducer].
   TState _state;
 
-  /// The second item in the pair returned by [React.userReducer].
+  /// The second item in the pair returned by [React.useReducer].
   void Function(TAction) _dispatch;
 
   ReducerHook(TState Function(TState state, TAction action) reducer, TState initialState) {
@@ -201,7 +201,7 @@ class ReducerHook<TState, TAction, TInit> {
   void dispatch(TAction action) => _dispatch(action);
 }
 
-/// Initializes state of a [DartFunctionComponent] to [initialState] and creates [dispatch] method.
+/// Initializes state of a [DartFunctionComponent] to [initialState] and creates a `dispatch` method.
 ///
 /// __Example__:
 ///
@@ -241,7 +241,7 @@ ReducerHook<TState, TAction, TInit> useReducer<TState, TAction, TInit>(
         TState Function(TState state, TAction action) reducer, TState initialState) =>
     ReducerHook(reducer, initialState);
 
-/// Initializes state of a [DartFunctionComponent] to [init(initialArg)] and creates [dispatch] method.
+/// Initializes state of a [DartFunctionComponent] to `init(initialArg)` and creates `dispatch` method.
 ///
 /// __Example__:
 ///
@@ -581,7 +581,7 @@ void useImperativeHandle(dynamic ref, dynamic Function() createHandle, [List<dyn
 ///   return isOnline;
 /// }
 ///
-/// final FriendListItem = react.registerFunctionComponent((Map props) {
+/// final FriendListItem = react.registerFunctionComponent((props) {
 ///   final isOnline = useFriendStatus(props['friend']['id']);
 ///
 ///   return react.li({