Prepare documentation and support docs

- Renamed `doc/` to `docs/`, to allow pushing support docs into that tree.
- Renamed `CONDUCT.md` to `CODE_OF_CONDUCT.md`.
- Added PR and issue templates.
- Added `SUPPORT.md`.

Author: weierophinney

.gitattributes

@@ -1,4 +1,4 @@
-/doc export-ignore
+/docs export-ignore
 /test export-ignore
 /.gitattributes export-ignore
 /.gitignore export-ignore

.gitignore

@@ -1,4 +1,4 @@
-doc/html/
+docs/html/
 vendor/
 phpunit.xml
 zf-mkdoc-theme/

composer.json

@@ -4,14 +4,24 @@
     "type": "library",
     "license": "BSD-3-Clause",
     "keywords": [
+        "expressive",
         "hal",
         "http",
         "psr",
         "psr-7",
         "psr-11",
         "psr-13",
-        "rest"
+        "rest",
+        "zf",
+        "zendframework"
     ],
+    "support": {
+        "docs": "https://docs.zendframework.com/zend-expressive-hal/",
+        "issues": "https://github.com/zendframework/zend-expressive-hal/issues",
+        "source": "https://github.com/zendframework/zend-expressive-hal",
+        "slack": "https://zendframework-slack.herokuapp.com",
+        "forum": "https://discourse.zendframework.com/c/questions/expressive"
+    },
     "config": {
         "sort-packages": true
     },

CONDUCT.md docs/CODE_OF_CONDUCT.md

@@ -5,12 +5,13 @@
 If you wish to contribute to this project, please be sure to
 read/subscribe to the following resources:
 
- -  [Coding Standards](https://github.com/zendframework/zend-coding-standard)
- -  [Forums](https://discourse.zendframework.com/c/contributors)
- -  [Slack](https://zendframework-slack.herokuapp.com)
+ - [Coding Standards](https://github.com/zendframework/zend-coding-standard)
+ - [Forums](https://discourse.zendframework.com/c/contributors)
+ - [Slack](https://zendframework-slack.herokuapp.com)
+ - [Code of Conduct](CODE_OF_CONDUCT.md)
 
-If you are working on new features or refactoring [create a
-proposal](https://github.com/zendframework/zend-expressive-hal/issues/new).
+If you are working on new features or refactoring
+[create a proposal](https://github.com/zendframework/zend-expressive-hal/issues/new).
 
 ## RUNNING TESTS
 
@@ -155,7 +156,7 @@ To send a pull request, you have two options.
 If using GitHub, you can do the pull request from there. Navigate to
 your repository, select the branch you just created, and then select the
 "Pull Request" button in the upper right. Select the user/organization
-"zendframework" as the recipient.
+"zendframework" (or whatever the upstream organization is) as the recipient.
 
 #### What branch to issue the pull request against?
 
@@ -186,7 +187,3 @@ repository, we suggest doing some cleanup of these branches.
    ```console
    $ git push {username} :<branchname>
    ```
-
-## Conduct
-
-Please see our [CONDUCT.md](CONDUCT.md) to understand expected behavior when interacting with others in the project.

CONTRIBUTING.md docs/CONTRIBUTING.md

@@ -0,0 +1,11 @@
+Provide a narrative description of what you are trying to accomplish.
+
+### Code to reproduce the issue
+
+```php
+```
+
+### Expected results
+
+### Actual results
+

docs/ISSUE_TEMPLATE.md

@@ -0,0 +1,17 @@
+Provide a narrative description of what you are trying to accomplish:
+
+- Are you fixing a bug?
+  - Detail how the bug is invoked currently.
+  - Detail the original, incorrect behavior.
+  - Detail the new, expected behavior.
+
+- Are you creating a new feature?
+  - Why is the new feature needed? What purpose does it serve?
+  - How will users use the new feature?
+
+- Is this related to quality assurance?
+  - Detail why the changes are necessary.
+
+- Is this related to documentation?
+  - Is it a typographical and/or grammatical fix?
+  - Is it new documentation?

docs/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,25 @@
+# Getting Support
+
+Zend Framework offers three support channels:
+
+- For real-time questions, use our
+  [Slack](https://zendframework-slack.herokuapp.com)
+- For detailed questions (e.g., those requiring examples) use our
+  [forums](https://discourse.zendframework.com/c/contributors)
+- To report issues, use this repository's
+  [issue tracker](https://github.com/{org}/{repo}/issues/new)
+
+**DO NOT** use the issue tracker to ask questions; use Slack or the forums for
+that. Questions posed to the issue tracker will be closed.
+
+When reporting an issue, please include the following details:
+
+- A narrative description of what you are trying to accomplish.
+- The minimum code necessary to reproduce the issue.
+- The expected results of exercising that code.
+- The actual results received.
+
+We may ask for additional details: what version of the library you are using,
+and what PHP version was used to reproduce the issue.
+
+You may also submit a failing test case as a pull request.

docs/SUPPORT.md

@@ -1,5 +1,5 @@
-docs_dir: doc/book
-site_dir: doc/html
+docs_dir: docs/book
+site_dir: docs/html
 pages:
     - index.md
     - Introduction: intro.md