Documentation for web apps and navigating complex web apps is always broken

Here’s why – web apps constantly get updated, links, text, etc change. Documentation does not.

Here’s an example – I want to edit an incoming webhook for Slack. Here’s the documentation:

This mentions Set up Incoming Webhooks but does not mention Editing Webhooks. Let’s try and edit it using the instructions on this page.

  1. step 5 says: Use your Incoming Webhook URL to post a message to Slack and links to:
  2. step 2 says:(if you are using an existing app, just load its settings via the Your Apps page). This links to:
  3. which has a blank page saying Create an App. At the bottom it says “Don’t see an app you’re looking for? Sign into another workspace” – clicking that says: You’re already signed in to this workspace – and lists the workspace
  4. going back the left menu says: Incoming webhooks – which takes you back to step 1
  5. Fortunately I’d bookmarked the page to edit the Incoming Webhook – it was https://<org><9 letter code>
  6. I hoped I could get to it from https://<org> but this redirects you back to https://<org> which lists apps, custom integrations

I have no idea how you actually get to the webhook you’re looking for.

Leave a Reply

Your email address will not be published. Required fields are marked *