Re: [Specifications] Introduced two new use cases related to API documentation and collection pagination

Review status: 2 of 5 files reviewed at latest revision, 9 unresolved discussions.

---

*[drafts/use-cases/2.1.api-documentation-data-structures.md, line 1 at r1](https://reviewable.io:443/reviews/hydracg/specifications/159#-L7TOIWl3Y1qaNywobmq:-L7a70hdnf5xIYEdXcp-:bh46iwj) ([raw file](https://github.com/hydracg/specifications/blob/9ec1f3c4b27ee71e17c55325465f43f85e77ffe3/drafts/use-cases/2.1.api-documentation-data-structures.md#L1)):*
<details><summary><i>Previously, lanthaler (Markus Lanthaler) wrote…</i></summary><blockquote>

Looks like you forgot to push your changes.
</blockquote></details>

Nope - looks like Reviable misbehaves. See (this)[https://github.com/HydraCG/Specifications/pull/159/files#diff-5d0fa46b254a904910d47b58d99d20d8] file - it's correct now.

---

*[drafts/use-cases/2.1.api-documentation-data-structures.md, line 44 at r1](https://reviewable.io:443/reviews/hydracg/specifications/159#-L7TP-83BXSVMKMmo54r:-L7a7BzLnV4XddV52jk4:b3w80ll) ([raw file](https://github.com/hydracg/specifications/blob/9ec1f3c4b27ee71e17c55325465f43f85e77ffe3/drafts/use-cases/2.1.api-documentation-data-structures.md#L44)):*
<details><summary><i>Previously, lanthaler (Markus Lanthaler) wrote…</i></summary><blockquote>

What about `/api-documentation` then? It is an actual API resource btw. ;-) A crucial part of its interface
</blockquote></details>

Well, `/api-documentation` feels better.

I understand that that documentation is a crutial part of its interface, but I wouldn't like to see the documentation mixed with other business-logic related resources.

---


*Comments from [Reviewable](https://reviewable.io:443/reviews/hydracg/specifications/159)*
<!-- Sent from Reviewable.io -->


-- 
GitHub Notification of comment by alien-mcl
Please view or discuss this issue at https://github.com/HydraCG/Specifications/pull/159#issuecomment-373158599 using your GitHub account

Received on Wednesday, 14 March 2018 20:11:59 UTC