# Doku lässt zu wünschen übrig

**URL:** <https://forum.shopware.com/t/doku-lasst-zu-wunschen-ubrig/54781>\
**Category:** Programmierung\
**Created:** [23. August 2018 um 15:57 UTC](https://forum.shopware.com/t/doku-lasst-zu-wunschen-ubrig/54781 "2018-08-23T15:57:19Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![volkerstraehle](https://avatars.discourse-cdn.com/v4/letter/v/e47c2d/32.png) [@volkerstraehle](https://forum.shopware.com/u/volkerstraehle)\
**Post date:** [23. August 2018 um 15:57 UTC](https://forum.shopware.com/t/doku-lasst-zu-wunschen-ubrig/54781/1 "2018-08-23T15:57:19Z")

</div>

Kann es sein, dass die Doku, z. B. [REST API - Categories Resource](https://developers.shopware.com/developers-guide/rest-api/api-resource-categories/) nicht aktuell gehalten wird und Fehler enthält?

Bleiben wir bei obigem Beispiel:

Abfrage per GET

Rückgabewerte:

…

emotions&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; array\*\*&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [Media](https://developers.shopware.com/developers-guide/rest-api/models/#media)\*\*

media&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Media

…

Und dann fehlen in der Liste der Rückgabewerte Felder wie sortingIds, hideSortings oder facetIds obwohl die im JSON-Array als Rückgabe enthalten sind.

---

<div class="post-metadata">

**Author:** ![pemmler](https://avatars.discourse-cdn.com/v4/letter/p/c68b51/32.png) [@pemmler](https://forum.shopware.com/u/pemmler)\
**Post date:** [23. August 2018 um 20:22 UTC](https://forum.shopware.com/t/doku-lasst-zu-wunschen-ubrig/54781/2 "2018-08-23T20:22:28Z")

</div>

Das ist wie “countryen”.  
Und das ist doch das Salz in der Suppe.  
Sonst wärs ja langweilig. 😉

Damals gabs noch so ein Meldeformular unter jeder Doku mit der man sowas melden konnte…

---

<div class="post-metadata">

**Author:** ![Michael\_Telgmann](https://dub1.discourse-cdn.com/flex013/user_avatar/forum.shopware.com/michael_telgmann/32/20289_2.png) [@Michael\_Telgmann](https://forum.shopware.com/u/Michael_Telgmann)\
**Post date:** [24. August 2018 um 05:57 UTC](https://forum.shopware.com/t/doku-lasst-zu-wunschen-ubrig/54781/3 "2018-08-24T05:57:34Z")

</div>

Hallo zusammen,

es kann durchaus sein, dass die Doku Lücken hat.&nbsp;  
Einen “Melden” Button in der Form gibt es so nicht mehr. Allerdings findet ihr auf jeder Seite der DevDocs ganz oben einen Button, wo ihr die Seite auf GitHub ändern könnt. Ansonsten dürft ihr natürlich auch gerne ein Issue beim Repo aufmachen:&nbsp;[GitHub - shopware/devdocs: Shopware 5 Developers Website](https://github.com/shopware/devdocs)

Viele Grüße aus Schöppingen

![cool](https://europe1.discourse-cdn.com/flex013/uploads/shopware/original/1X/86c57fbace799dd4eb1f1b8a2d3bdc1733f0aea1.png "cool")&nbsp;Michael Telgmann

---

<div class="post-metadata">

**Author:** ![volkerstraehle](https://avatars.discourse-cdn.com/v4/letter/v/e47c2d/32.png) [@volkerstraehle](https://forum.shopware.com/u/volkerstraehle)\
**Post date:** [24. August 2018 um 08:15 UTC](https://forum.shopware.com/t/doku-lasst-zu-wunschen-ubrig/54781/4 "2018-08-24T08:15:06Z")

</div>

Nur mal für mich zum Verständnis: Da gibt es Entwickler, die bauen neue Felder in die DB ein und erweitern die API, aber die Doku pflegen Sie nicht? Sorry, aber wer eine Kaufversion von SW nutzt sollte eigentlich davon ausgehen, dass die Doku vollständig und korrekt ist. Wenigstens könnte bei jeder Seite dabei stehen auf welcher SW-Version Sie bassiert. Wenn dann da steht 5.3 und aktuell ist eine 5.5, dan weiss man wnigstens, dass die nicht ganz aktuell ist.
