search

ballerina-platform / ballerina-lang

The Ballerina Programming Language
https://ballerina.io/
Apache License 2.0
3.66k stars 750 forks source link

Docerina does not support for Ballerina Services - (API Documentation) #43507

Open KasunAratthanage opened 6 years ago

KasunAratthanage commented 6 years ago

Description:

Docerina does not support for generateing API documentation for Ballerina services. However while executing a "ballerina doc" command API documentation is generated in HTML format but content of that document is empty for Ballerina services.

Steps to reproduce: Please find the following recreation steps

1) Create a simple Ballerina service. 2) Then insert API documentation annotations for above service. 3) Run "ballerina doc" command.

Output API documentation generated successfully. But content is empty.

Affected Versions:

OS, DB, other environment details and versions:

Related Issues (optional):

Suggested Labels (optional):

Suggested Assignees (optional):

riyafa commented 6 years ago

This is also not working with the syntax changes by https://github.com/ballerina-platform/ballerina-lang/pull/10041 and needs to be fixed.

riyafa commented 6 years ago

Refer mail: https://groups.google.com/d/msg/ballerina-dev/wK1UPRrE4Hk/TRELPLY7AQAJ