Build jsdoc with HTML output

Open
#911 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
25/100
Issue type
Feature
Clarity
Needs clarification
Activity status
Stale
Tech stack
javascript

Research direction

The issue names the build jsdoc task and generated api.json files but no source file or test. Start by tracing that task and the api.json flow; done would be a documented way to consume the files or a defined HTML-output or plugin path, with validation for the chosen behavior.

Written by the indexing model from the issue text.

Description

Hello,

I'm currently trying to gather our companies custom UI5 implementations in reusable libraries and host an internal API documentation for them.

I found the "build jsdoc" option to build documentation alongside the libraries but it only outputs api.json files which somehow should be able to be inserted into the UI5 SDK and viewed there?! But there is no documentation on how to do that either.

Are there plans to include a HTML output to the build jsdoc task or a custom plugin for jsdoc itself to support UI5 Syntax?
On the other hand a guide on how to handle the generated api.json files would help too i guess.

Dominant language
JavaScript
Stars
511
Forks
83
Avg merge
1d 5h
Merged PRs (30d)
55

Contributor guide

Open the contributing guide

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.

More from UI5/cli

All issues in UI5/cli

Similar issues

More JavaScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.