Kong / Kong/developer.konghq.com
fix: Add info about Dev Portal homepage slugs
Nobody has claimed this yet.
- Dominant language
- Ruby
- Stars
- 28
- Forks
- 121
- Avg merge
- 1d 4h
- Merged PRs (30d)
- 313
Description
Jobs to be done (optional)
It's unclear to customers how to make a Dev Portal homepage via the API or Terraform (in the UI, this is created for them by default). When they try to make one, like /home, it gives them a 404.
Definition of done
- Document that they need to create a
/page (if they're using the API or TF) to create a home page here https://developer.konghq.com/dev-portal/apis/#page-structure - Update the page creation steps here and here so that they create a homepage with
/as well as the already documented/apispage with a sentence that describes that this is creating a homepage for them as well as a page for their apis.
Information
Slack feedback: https://kongstrong.slack.com/archives/CDSTDSG9J/p1756386574049769
Due date (optional)
N/A
Size
Small
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the linked Dev Portal page-structure documentation and the Dev Portal sections in the API Catalog and Terraform automation guides. Locate their source files, document that / creates the homepage, and update both creation walkthroughs to create / alongside /apis; done when all three linked pages explain the homepage behavior.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- terraform
- Domain
- api, documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Clearly specified
- Newbie friendliness
- 45/100