doc

Author: nicolas-van

.jsdoc.json

@@ -1,6 +1,12 @@
 {
   "source": {
-    "include": ["src", "package.json", "README.md"],
+    "include": [
+      "src",
+      "package.json",
+      "README.md",
+      "CONTRIBUTING.md",
+      "LICENSE.md"
+    ],
     "includePattern": ".js$"
   },
   "plugins": ["plugins/markdown"],

CONTRIBUTING.md

@@ -0,0 +1,85 @@
+# Contributing to this project
+
+* [Contributors Agreement](#user-content-contributors-agreement)
+* [Introduction](#Introduction)
+  * [I don't want to read this whole thing I just have a question!!!](#user-content-i-dont-want-to-read-this-whole-thing-i-just-have-a-question)
+* [How Can I Contribute?](#user-content-how-can-i-contribute)
+  * [Reporting Bugs](#user-content-reporting-bugs)
+  * [Suggesting Enhancements](#user-content-suggesting-enhancements)
+  * [Creating Pull Requests](#user-content-creating-pull-requests)
+  
+## Contributors Agreement
+
+By submitting patches to this project you agree to allow them to be redistributed under the project's license, according to the normal forms and usages of the open-source community.
+
+## Introduction
+
+First off, thank you for considering contributing to this project. It's people like you that make it such a great tool.
+
+Following these guidelines helps to communicate that you respect the time of the developers managing and developing this open source project. In return, they should reciprocate that respect in addressing your issue, assessing changes, and helping you finalize your pull requests.
+
+This is an open source project and we love to receive contributions from our community — you! There are many ways to contribute, from writing tutorials or blog posts, improving the documentation, submitting bug reports and feature requests or writing code which can be incorporated into the main project itself.
+
+### I don't want to read this whole thing I just have a question!!!
+
+We currently allow our users to use the issue tracker for support questions. But please be wary that maintaining an open source project can take a lot of time from the maintainers. If asking for a support question, state it clearly and take the time to explain your problem properly. Also, if your problem is not strictly related to this project we recommend you to use Stack Overlow instead.
+
+## How Can I Contribute?
+
+### Feature Requests
+
+This section guides you through submitting an enhancement suggestion for this project, including completely new features and minor improvements to existing functionality. Following these guidelines helps maintainers and the community understand your suggestion and find related suggestions.
+
+Before creating enhancement suggestions, please check the list of enhancements suggestions in the issue tracker as you might find out that you don't need to create one. When you are creating an enhancement suggestion, please include as many details as possible.
+
+#### How Do I Submit A (Good) Enhancement Suggestion?
+
+Enhancement suggestions are tracked as [GitHub issues](https://guides.github.com/features/issues/). Create an issue on the project's repository and provide the following information:
+
+* **Use a clear and descriptive title** for the issue to identify the suggestion.
+* **Provide a step-by-step description of the suggested enhancement** in as many details as possible.
+* **Provide specific examples to demonstrate the steps**. It's always better to get more information. You can include links to files or GitHub projects, copy/pasteable snippets or even print screens or animated GIFS. If you're providing snippets in the issue, use [Markdown code blocks](https://help.github.com/articles/markdown-basics/#multiple-lines).
+* **Describe the current behavior** and **explain which behavior you expected to see instead** and why.
+* **List some other similar projects where this enhancement exists.**
+* **Specify which version of the project you're using.**
+* **Specify the current environment you're using.** if this is a useful information.
+
+### Reporting Bugs
+
+Before creating bug reports, please check the existing bug reports as you might find out that you don't need to create one. When you are creating a bug report, please include as many details as possible.
+
+#### How Do I Submit A (Good) Bug Report?
+
+Bugs are tracked as [GitHub issues](https://guides.github.com/features/issues/). Create an issue on the project's repository and provide the following information.
+
+Explain the problem and include additional details to help maintainers reproduce the problem:
+
+* **Use a clear and descriptive title** for the issue to identify the problem.
+* **Describe the exact steps which reproduce the problem** in as many details as possible. For example, start by explaining how you used the project. When listing steps, **don't just say what you did, but explain how you did it**.
+* **Provide specific examples to demonstrate the steps**. It's always better to get more information. You can include links to files or GitHub projects, copy/pasteable snippets or even print screens or animated GIFS. If you're providing snippets in the issue, use [Markdown code blocks](https://help.github.com/articles/markdown-basics/#multiple-lines).
+* **Describe the behavior you observed after following the steps** and point out what exactly is the problem with that behavior.
+* **Explain which behavior you expected to see instead and why.**
+* **If the problem wasn't triggered by a specific action**, describe what you were doing before the problem happened and share more information using the guidelines below.
+
+Provide more context by answering these questions:
+
+* **Did the problem start happening recently** (e.g. after updating to a new version) or was this always a problem?
+* If the problem started happening recently, **can you reproduce the problem in an older version?** What's the most recent version in which the problem doesn't happen?
+* **Can you reliably reproduce the issue?** If not, provide details about how often the problem happens and under which conditions it normally happens.
+
+Include details about your configuration and environment:
+
+* **Which version of the project are you using?**
+* **What's the name and version of the OS you're using**?
+* **Any other information that could be useful about you environment**
+
+### Creating Pull Requests
+
+#### How Do I Submit A (Good) Pull Request?
+
+* **Be warned that the contributors agreement displayed on top of this document is applicable as soon as you create a pull request**.
+* **Use a clear and descriptive title** for the pull request to state the improvement you made to the code or the bug you solved.
+* **Provide a link to the related issue** if the pull request is a follow up of an existing bug report or enhancement suggestion.
+* **Comment why this pull request represents an enhancement** and give a rationale explaining why you did it that way and not another way.
+* **Use the same coding style than the one used in this project**.
+* **Welcome suggestions from the maintainers to improve your pull request**. 

README.md

@@ -3,3 +3,48 @@
 [![Node.js CI](https://github.com/nicolas-van/modern-async/workflows/Node.js%20CI/badge.svg)](https://github.com/nicolas-van/modern-async/actions) [![npm](https://img.shields.io/npm/v/modern-async)](https://www.npmjs.com/package/modern-async)
 
 A modern JavaScript tooling library for asynchronous operations using async/await and promises.
+
+This library is a modernized alternative to a lot of libraries like [Async.js](https://caolan.github.io/async/v3/) that were created using the legacy callback style to handle asynchronous operations. Its goal is to be as complete as any of those libraries while being built from the very beginning with async/await and promises in mind.
+
+[See the documentation](https://nicolas-van.github.io/modern-async).
+
+* Exclusively uses async/await and promises in its code, tests and documentation.
+* Has almost no dependencies.
+* Has 100% code coverage.
+* Bundled for ESM modules, CommonJS and UMD.
+* Works in node >= 10.0 and in the vast majority of browsers (if using babel or the UMD version).
+
+## This project accepts feature requests !
+
+The goal of modern-async is to be as complete as possible. I coded everything I missed in past while developing, yet it's difficult to know what people would really need. So if you would like some more feature start by [reading the contribution guide](https://github.com/nicolas-van/modern-async/blob/master/CONTRIBUTING.md).
+
+## Installation
+
+```bash
+npm install --save modern-async
+```
+
+## Usage
+
+```javascript
+import { map, asyncRoot, sleep } from 'modern-async'
+
+// or
+
+const { map, asyncRoot, sleep } = require('modern-async')
+
+asyncRoot(async () => {
+  const array = [1, 2, 3]
+  const result = await map(array, async (v) => {
+    await sleep(10)
+    return v * 2
+  })
+  console.log(result)
+})
+```
+
+[See the documentation for the rest](https://nicolas-van.github.io/modern-async).
+
+## License
+
+[See the license here](https://github.com/nicolas-van/modern-async/blob/master/LICENSE.md)

docs/index.html

@@ -2,7 +2,7 @@
 <html lang="en">
   <head>
     <script>
-      window.location = "./modern-async/0.1.0"
+      window.location = "./modern-async/0.1.2"
     </script>
   </head>
 </html>