Update readme

Author: danez

README.md

@@ -1,22 +1,19 @@
 # react-docgen
 
-`react-docgen` is a CLI and toolbox to help extracting information from [React][] components, and generate documentation from it.
+[`react-docgen`](./packages/react-docgen/) is a highly customizable library that extracts information from
+[React](https://reactjs.org/) components and returns this information in a
+structured machine readable format from which documentations can be generated.
 
-It uses [@babel/parser][] to parse the source into an AST and provides methods to process this AST to extract the desired information. The output / return value is a JSON blob / JavaScript object.
-
-It provides a default implementation for React components defined via
-`React.createClass`, [ES2015 class definitions][classes] or functions
-(stateless components). These component definitions must follow certain
-guidelines in order to be analyzable (see below for more info).
-
-> react-docgen is a low level tool to extract information about react components. If you are searching for a more high level styleguide with nice interface try [react-styleguidist](https://github.com/styleguidist/react-styleguidist) or any of the other tools listed in the [wiki](https://github.com/reactjs/react-docgen/wiki).
+[`@react-docgen/cli`](./packages/react-docgen-cli/) is a cli wrapper around the library allowing using `react-docgen` on the command line.
 
 ## Documentation
 
 For version 5.x please checkout the [README.md on the 5.x branch](https://github.com/reactjs/react-docgen/blob/5.x/README.md)
 
 For version 6.x please checkout [react-docgen.dev](https://react-docgen.dev)
 
+Version 6 is currently only available as alpha version (latest being `6.0.0-alpha.4`)
+
 ## License
 
 This project is licensed under the MIT License.

packages/website/pages/index.mdx

@@ -1,12 +1,12 @@
-import { Callout } from "nextra-theme-docs";
+import { Callout } from 'nextra-theme-docs';
 
 # Welcome to react-docgen!
 
 <Callout emoji="🚧">This website is under construction</Callout>
 
 `react-docgen` is a highly customizable library that extracts information from
 [React](https://reactjs.org/) components and returns this information in a
-structured machine readable documentation.
+structured machine readable format from which documentations can be generated.
 
 It uses [Babel](https://babel.dev/) to parse the source into an AST and provides
 methods to process this AST to extract the desired information. The output /
@@ -27,5 +27,4 @@ to be analyzable (see below for more info).
   tools using react-docgen.)
 </Callout>
 
-[classes]:
-  https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes
+[classes]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes