Open gayaldassanayake opened 5 months ago
Had an offline discussion regarding this with @anupama-pathirage. All these topics are mostly used by internal developers. As an initial step, these documentations will be added under https://github.com/ballerina-platform/ballerina-lang/tree/master/docs.
Related design doc - https://docs.google.com/document/d/145VFCbfUZxB6HZ3RHKgHEcKehXqRvFEZHNqeG--tYt8/edit?usp=sharing
Description
Certain advanced topics are not required for any beginner or intermediate users, but are helpful for the advanced users.
Following are such examples.
bal scan
toolFor some of these cases,
Related website/documentation area
Describe the problem(s)
Not having official documentation can cause time-wasting and confusion for internal developers. External developers may not be able to find these unofficial how-to guides, hence might not be able to accomplish desired tasks entirely.
Describe your solution(s)
Introduce a section of documentation for advanced users. For this, we need to look at how other programming languages/ technologies have documented and presented such topics to the users.
Related issue(s) (optional)
Suggested label(s) (optional)
Suggested assignee(s) (optional)