docs: Reorganize "Incoming webhooks" section of API docs. #13511
Conversation
timabbott
force-pushed
the
docs-api-webhooks
branch
from
027a08e
to
9c93d14
Compare
|
I'm not happy with how this ends up feeling, though I think it's progress. I pushed back here with some naming edits. I think the next thing to try is if merging the "Overview" page to be the bottom of the "Home" page (/api/) would improve things, since that section is clearly not intended to be scoped within the "Incoming webhooks" section. |
* Rename "Integrations" section to "Incoming webhooks". * Rename "Incoming webhook integrations" item to "Webhook integrations". * Rename "Hello world walkthrough" item to "Integration walkthrough". * Rename "Non-webhook integrations" item to "Other integrations". * Add new "Generic incoming webhook" item that links to api/send-message
drrosa
force-pushed
the
docs-api-webhooks
branch
from
9c93d14
to
520f102
Compare
|
Yeah, that does appear to improve things. I left the headings unchanged after merging the Integrations Overview page though. It just didn't look right to me after increasing the level of headings. But not sure if it would be acceptable to have two top-level headings in the /api home page. What do you think? |
|
Heads up @drrosa, we just merged some commits that conflict with the changes your made in this pull request! You can review this repository's recent commits to see where the conflicts occur. Please rebase your feature branch against the |
timabbott
force-pushed
the
main
branch
2 times, most recently
from
4ec3636
to
88b200c
Compare
Discussion:
https://chat.zulip.org/#narrow/stream/31-production-help/topic/webhooks/near/801262