wso2 / wso2/docs-apim

[Doc Bug] Outdated Service Provider names and broken link in "Log in to the Developer Portal Using Social Media" (APIM 4.7.0)

Open Beginner friendly
#10,844 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

API-M-4.7.0
Dominant language
CSS
Stars
99
Forks
708
Avg merge
1d 7h
Merged PRs (30d)
22

Description

Description

There are two issues on the documentation page for configuring social media login for the Developer Portal in WSO2 API Manager 4.7.0:

  1. Outdated Service Provider Names: Step 3 of the guide instructs users to edit the admin_admin_publisher (and presumably admin_admin_store) service providers.
  2. Broken Link: In the "Note" block, the link for "Setting up an e-mail login" is broken and leads to a "Page Not Found" (404) error.

Documentation URL: https://apim.docs.wso2.com/en/4.7.0/reference/customize-product/customizations/log-in-to-the-dev-portal-using-social-media/

Steps to Reproduce
  1. Navigate to the documentation URL mentioned above.
  2. Look at the blue "Note" box near the top of the page.
  3. Click on the hyperlink "Setting up an e-mail login". Observe that it leads to a non-existent page.
  4. Scroll down to Step 3 under the instructions.
  5. Observe the text: "Click Edit to edit the admin_admin_publisher".
  6. Log into a fresh WSO2 Identity Server / API Manager Management Console (https://localhost:9443/carbon) and navigate to Service Providers > List.
  7. Observe that admin_admin_publisher does not exist.
Version

WSO2 API Manager 4.7.0-m2 (Documentation version 4.7.0)

Environment Details (with versions)

Ubuntu 24
JDK 21 - APIM
JDK 11 - IS

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Open the 4.7.0 documentation page for logging in to the Developer Portal using social media. Check the Note block's “Setting up an e-mail login” link and Step 3's admin_admin_publisher and admin_admin_store names against the Service Providers list described in the issue. Done means the link resolves and the instructions use the current service provider names.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
72/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.