eventing-contrib API and consistent file names (#1805)

Author: RichieEscarez

docs/reference/README.md

@@ -11,7 +11,7 @@ The API source files are located at:
 
 - [Serving API](./serving.md)
 - [Eventing API](./eventing/eventing.md)
-- [Eventing-contrib resources API](./eventing/eventing-resources.md)
+- [Eventing-contrib resources API](./eventing/eventing-contrib.md)
 
 ## Updating API Reference docs (for Knative maintainers)
 
@@ -57,18 +57,20 @@ To generate a version of the API:
 1. Locate the commits or tags that correspond to the version of the API that you
    want to generate:
 
+   - [Serving](https://github.com/knative/serving/releases/)
    - [Eventing](https://github.com/knative/eventing/releases/)
    - [Eventing-contrib resources](https://github.com/knative/eventing-contrib/releases/)
-   - [Serving](https://github.com/knative/serving/releases/)
 
 1. To run the `gen-api-reference-docs.sh` command from the `hack` directory, you
    specify the commits or tags for each of the corresponding Knative component
    variables (`KNATIVE_[component_name]_COMMIT`):
 
    ```
-   KNATIVE_EVENTING_COMMIT=[commit_or_tag] \
-   KNATIVE_EVENTING_SOURCES_COMMIT=[commit_or_tag] \
+   cd hack
+   
    KNATIVE_SERVING_COMMIT=[commit_or_tag] \
+   KNATIVE_EVENTING_COMMIT=[commit_or_tag] \
+   KNATIVE_EVENTING_CONTRIB_COMMIT=[commit_or_tag] \
    ./gen-api-reference-docs.sh
    ```
 
@@ -85,12 +87,6 @@ To generate a version of the API:
 1. Copy the generated API files into the `docs/reference` directory of your
    knative/docs clone.
 
-1. IMPORTANT: There are some limitations to the build script that require manual
-   changes to the HTML. For the `serving.md` and
-   `eventing-contrib-resources.md`, you must manually fix the `Packages` lists.
-   Details for the required manual changes are in
-   [PR 1552](https://github.com/knative/docs/pull/1552#issuecomment-506891983).
-
 You can now perform the necessary steps to open a PR, complete a review, and
 merge the new API files into the appropriate branch of the `knative/docs` repo.
 See the [contributor flow](../../contributing/DOCS-CONTRIBUTING.md) for details
@@ -108,8 +104,8 @@ Using tags from each repo, you would run the following command to generate the
 v0.3.0 API source files:
 
 ```
-KNATIVE_EVENTING_COMMIT=v0.3.0 \
-KNATIVE_EVENTING_SOURCES_COMMIT=v0.3.0 \
 KNATIVE_SERVING_COMMIT=v0.3.0 \
+KNATIVE_EVENTING_COMMIT=v0.3.0 \
+KNATIVE_EVENTING_CONTRIB_COMMIT=v0.3.0 \
 ./gen-api-reference-docs.sh
 ```

docs/reference/eventing/eventing-contrib-api.md

@@ -5,4 +5,4 @@ weight: 50
 type: "docs"
 ---
 
-{{< readfile file="eventing-contrib-resources.md" relative="true" >}}
+{{< readfile file="eventing-contrib.md" relative="true" >}}