Merge branch 'master' into develop

.github/ISSUE_TEMPLATE.md

@@ -1,15 +1,18 @@
 <!--- Please provide a summary in the title and describe your issue here.
 Is this a bug or feature request? If a bug, include all the steps that led to the issue.
 
-If you're looking for help with your code, consider posting a question on Stack Overflow instead:
+If you're looking for help with your code, consider posting a question here:
-http://stackoverflow.com/questions/tagged/spacy -->
-
 
+- GitHub Discussions: https://github.com/explosion/spaCy/discussions
+- Stack Overflow: http://stackoverflow.com/questions/tagged/spacy
+-->
 
 ## Your Environment
+
 <!-- Include details of your environment. If you're using spaCy 1.7+, you can also type
 `python -m spacy info --markdown` and copy-paste the result here.-->
-* Operating System: 
+
-* Python Version Used: 
+- Operating System:
-* spaCy Version Used: 
+- Python Version Used:
-* Environment Information: 
+- spaCy Version Used:
+- Environment Information:

.github/ISSUE_TEMPLATE/03_request.md

@@ -1,11 +0,0 @@
----
-name: "\U0001F381 Feature Request"
-about: Do you have an idea for an improvement, a new feature or a plugin?
-
----
-
-## Feature description
-<!-- Please describe the feature: Which area of the library is it related to? What specific solution would you like? -->
-
-## Could the feature be a [custom component](https://spacy.io/usage/processing-pipelines#custom-components) or [spaCy plugin](https://spacy.io/universe)?
-If so, we will tag it as [`project idea`](https://github.com/explosion/spaCy/labels/project%20idea) so other users can take it on.

.github/ISSUE_TEMPLATE/04_other.md

@@ -0,0 +1,19 @@
+---
+name: "\U0001F4AC Anything else?"
+about: For feature and project ideas, general usage questions or help with your code, please post on the GitHub Discussions board instead.
+---
+
+<!-- Describe your issue here. Please keep in mind that the GitHub issue tracker is mostly intended for reports related to the spaCy code base and source, and for bugs and enhancements. If you're looking for help with your code, consider posting a question here:
+
+- GitHub Discussions: https://github.com/explosion/spaCy/discussions
+- Stack Overflow: http://stackoverflow.com/questions/tagged/spacy
+-->
+
+## Your Environment
+
+<!-- Include details of your environment. If you're using spaCy 1.7+, you can also type `python -m spacy info --markdown` and copy-paste the result here.-->
+
+- Operating System:
+- Python Version Used:
+- spaCy Version Used:
+- Environment Information:

.github/ISSUE_TEMPLATE/05_other.md

@@ -1,15 +0,0 @@
----
-name: "\U0001F4AC Anything else?"
-about: For general usage questions or help with your code, please consider
-  posting on Stack Overflow instead.
-
----
-
-<!-- Describe your issue here. Please keep in mind that the GitHub issue tracker is mostly intended for reports related to the spaCy code base and source, and for bugs and feature requests. If you're looking for help with your code, consider posting a question on Stack Overflow instead: http://stackoverflow.com/questions/tagged/spacy -->
-
-## Your Environment
-<!-- Include details of your environment. If you're using spaCy 1.7+, you can also type `python -m spacy info --markdown` and copy-paste the result here.-->
-* Operating System:
-* Python Version Used:
-* spaCy Version Used:
-* Environment Information:

CONTRIBUTING.md

@@ -26,11 +26,11 @@ also often include helpful tips and solutions to common problems. You should
 also check the [troubleshooting guide](https://spacy.io/usage/#troubleshooting)
 to see if your problem is already listed there.
 
-If you're looking for help with your code, consider posting a question on
+If you're looking for help with your code, consider posting a question on the
-[Stack Overflow](http://stackoverflow.com/questions/tagged/spacy) instead. If you
+[GitHub Discussions board](https://github.com/explosion/spaCy/discussions) or
-tag it `spacy` and `python`, more people will see it and hopefully be able to
+[Stack Overflow](http://stackoverflow.com/questions/tagged/spacy). Please
-help. Please understand that we won't be able to provide individual support via
+understand that we won't be able to provide individual support via email. We
-email. We also believe that help is much more valuable if it's **shared publicly**,
+also believe that help is much more valuable if it's **shared publicly**,
 so that more people can benefit from it.
 
 ### Submitting issues

README.md

@@ -60,13 +60,15 @@ be able to provide individual support via email. We also believe that help is
 much more valuable if it's shared publicly, so that more people can benefit from
 it.
 
-| Type                    | Platforms              |
+| Type                            | Platforms                               |
-| ----------------------- | ---------------------- |
+| ------------------------------- | --------------------------------------- |
-| 🚨 **Bug Reports**      | [GitHub Issue Tracker] |
+| 🚨 **Bug Reports**              | [GitHub Issue Tracker]                  |
-| 🎁 **Feature Requests** | [GitHub Issue Tracker] |
+| 🎁 **Feature Requests & Ideas** | [GitHub Discussions]                    |
-| 👩‍💻 **Usage Questions**  | [Stack Overflow]       |
+| 👩‍💻 **Usage Questions**          | [GitHub Discussions] · [Stack Overflow] |
+| 🗯 **General Discussion**        | [GitHub Discussions]                    |
 
 [github issue tracker]: https://github.com/explosion/spaCy/issues
+[github discussions]: https://github.com/explosion/spaCy/discussions
 [stack overflow]: https://stackoverflow.com/questions/tagged/spacy
 
 ## Features
@@ -126,6 +128,7 @@ environment to avoid modifying system state:
 ```bash
 python -m venv .env
 source .env/bin/activate
+pip install -U pip setuptools wheel
 pip install spacy
 ```
 
@@ -224,16 +227,28 @@ do that depends on your system. See notes on Ubuntu, OS X and Windows for
 details.
 
 ```bash
-# make sure you are using the latest pip
-python -m pip install -U pip
 git clone https://github.com/explosion/spaCy
 cd spaCy
 
 python -m venv .env
 source .env/bin/activate
-export PYTHONPATH=`pwd`
+
+# make sure you are using the latest pip
+python -m pip install -U pip setuptools wheel
+
+pip install .
+```
+
+To install with extras:
+
+```bash
+pip install .[lookups,cuda102]
+```
+
+To install all dependencies required for development:
+
+```bash
 pip install -r requirements.txt
-python setup.py build_ext --inplace
 ```
 
 Compared to regular install via pip, [requirements.txt](requirements.txt)
@@ -271,14 +286,13 @@ tests, you'll usually want to clone the repository and build spaCy from source.
 This will also install the required development dependencies and test utilities
 defined in the `requirements.txt`.
 
-Alternatively, you can find out where spaCy is installed and run `pytest` on
+Alternatively, you can run `pytest` on the tests from within the installed
-that directory. Don't forget to also install the test utilities via spaCy's
+`spacy` package. Don't forget to also install the test utilities via spaCy's
 `requirements.txt`:
 
 ```bash
-python -c "import os; import spacy; print(os.path.dirname(spacy.__file__))"
+pip install -r requirements.txt
-pip install -r path/to/requirements.txt
+python -m pytest --pyargs spacy
-python -m pytest <spacy-directory>
 ```
 
 See [the documentation](https://spacy.io/usage#tests) for more details and

setup.cfg

@@ -88,6 +88,8 @@ cuda102 =
     cupy-cuda102>=5.0.0b4,<9.0.0
 cuda110 =
     cupy-cuda110>=5.0.0b4,<9.0.0
+cuda111 =
+    cupy-cuda111>=5.0.0b4,<9.0.0
 # Language tokenizers with external dependencies
 ja =
     sudachipy>=0.4.9

website/UNIVERSE.md

@@ -11,8 +11,8 @@ suggest it by submitting a pull request to this repository. The Universe
 database is open-source and collected in a simple JSON file.
 
 Looking for inspiration for your own spaCy plugin or extension? Check out the
-[`project idea`](https://github.com/explosion/spaCy/labels/project%20idea) label
+[`project ideas`](https://github.com/explosion/spaCy/discussions?discussions_q=category%3A%22New+Features+%26+Project+Ideas%22) 
-on the issue tracker.
+discussion forum.
 
 ## Checklist
 

website/docs/usage/index.md

@@ -129,10 +129,11 @@ grateful to use the work of Chainer's [CuPy](https://cupy.chainer.org) module,
 which provides a numpy-compatible interface for GPU arrays.
 
 spaCy can be installed on GPU by specifying `spacy[cuda]`, `spacy[cuda90]`,
-`spacy[cuda91]`, `spacy[cuda92]`, `spacy[cuda100]`, `spacy[cuda101]` or
+`spacy[cuda91]`, `spacy[cuda92]`, `spacy[cuda100]`, `spacy[cuda101]`,
-`spacy[cuda102]`. If you know your cuda version, using the more explicit
+`spacy[cuda102]`, `spacy[cuda110]` or `spacy[cuda111]`. If you know your cuda
-specifier allows cupy to be installed via wheel, saving some compilation time.
+version, using the more explicit specifier allows cupy to be installed via
-The specifiers should install [`cupy`](https://cupy.chainer.org).
+wheel, saving some compilation time. The specifiers should install
+[`cupy`](https://cupy.chainer.org).
 
 ```bash
 $ pip install -U %%SPACY_PKG_NAME[cuda92]%%SPACY_PKG_FLAGS
@@ -263,6 +264,36 @@ You can configure the build process with the following environment variables:
 | `PYVER`        | The Python version to build against. This version needs to be available on your build and runtime machines. Defaults to `3.6`.                                                                              |
 | `WHEELHOUSE`   | Directory to store the wheel files during compilation. Defaults to `./wheelhouse`.                                                                                                                          |
 
+#### Additional options for developers {#source-developers}
+
+Some additional options may be useful for spaCy developers who are editing the
+source code and recompiling frequently.
+
+- Install in editable mode. Changes to `.py` files will be reflected as soon as
+  the files are saved, but edits to Cython files (`.pxd`, `.pyx`) will require
+  the `pip install` or `python setup.py build_ext` command below to be run
+  again. Before installing in editable mode, be sure you have removed any
+  previous installs with `pip uninstall spacy`, which you may need to run
+  multiple times to remove all traces of earlier installs.
+
+  ```diff
+    pip install -U pip setuptools wheel
+  - pip install .
+  + pip install -r requirements.txt
+  + pip install --no-build-isolation --editable .
+  ```
+
+- Build in parallel using `N` CPUs to speed up compilation and then install in
+  editable mode:
+
+  ```diff
+    pip install -U pip setuptools wheel
+  - pip install .
+  + pip install -r requirements.txt
+  + python setup.py build_ext --inplace -j N
+  + python setup.py develop
+  ```
+
 ### Run tests {#run-tests}
 
 spaCy comes with an [extensive test suite](%%GITHUB_SPACY/spacy/tests). In order
@@ -277,7 +308,7 @@ that directory. Don't forget to also install the test utilities via spaCy's
 ```bash
 $ python -c "import os; import spacy; print(os.path.dirname(spacy.__file__))"
 $ pip install -r path/to/requirements.txt
-$ python -m pytest [spacy directory]
+$ python -m pytest --pyargs %%SPACY_PKG_NAME
 ```
 
 Calling `pytest` on the spaCy directory will run only the basic tests. The flag
@@ -285,8 +316,8 @@ Calling `pytest` on the spaCy directory will run only the basic tests. The flag
 
 ```bash
 $ python -m pip install -U pytest               # update pytest
-$ python -m pytest [spacy directory]            # basic tests
+$ python -m pytest --pyargs %%SPACY_PKG_NAME               # basic tests
-$ python -m pytest [spacy directory] --slow     # basic and slow tests
+$ python -m pytest --pyargs %%SPACY_PKG_NAME --slow        # basic and slow tests
 ```
 
 ## Troubleshooting guide {#troubleshooting}

website/docs/usage/spacy-101.md

@@ -513,9 +513,10 @@ via the following platforms:
   questions** and everything related to problems with your specific code. The
   Stack Overflow community is much larger than ours, so if your problem can be
   solved by others, you'll receive help much quicker.
-- [Gitter chat](https://gitter.im/explosion/spaCy): **General discussion** about
+- [GitHub discussions](https://github.com/explosion/spaCy/discussions): **General 
-  spaCy, meeting other community members and exchanging **tips, tricks and best
+  discussion**, **project ideas** and **usage questions**. Meet other community 
-  practices**.
+  members to get help with a specific code implementation, discuss ideas for new 
+  projects/plugins, support more languages, and share best practices.
 - [GitHub issue tracker](https://github.com/explosion/spaCy/issues): **Bug
   reports** and **improvement suggestions**, i.e. everything that's likely
   spaCy's fault. This also includes problems with the trained pipelines beyond

website/meta/site.json

@@ -56,6 +56,10 @@
             "label": "Community",
             "items": [
                 { "text": "Universe", "url": "/universe" },
+                {
+                    "text": "GitHub Discussions",
+                    "url": "https://github.com/explosion/spaCy/discussions"
+                },
                 { "text": "Issue Tracker", "url": "https://github.com/explosion/spaCy/issues" },
                 {
                     "text": "Stack Overflow",