Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(api-reference): Improve API Discovery #1793

Open
mudlabs opened this issue Sep 28, 2019 · 1 comment
Open

docs(api-reference): Improve API Discovery #1793

mudlabs opened this issue Sep 28, 2019 · 1 comment
Labels

Comments

@mudlabs
Copy link
Contributor

@mudlabs mudlabs commented Sep 28, 2019

Is your feature request related to a problem? Please describe.

When trying to learn more about a given API in the docs it can be difficult to locate the component specific properties and methods; as they are mixed with all its inherited ones.

Describe the solution you'd like

Instead of having the component properties and methods mixed in with the sea of inherited properties and methods, I propose a separation within the Index.

Describe alternatives you've considered

  • Doing a ⌘F (find in page), but that's not very useful if you don't already know what you're looking for.
  • Scrolling all the way to the bottom of the page to workout what the little icons mean. And then trying to spot the ones you want (ain't no body got time for that). And something new devs could easily miss.

Additional context

The Current Index Structure

Index
Constructors
The constructor(s).
Properties
All properties (including inherited etc...), in alphabetical order.
Methods
All methods (including inherited etc...), in alphabetical order.

Proposed Index Structure

Index
Constructors
The constructor(s).
Properties
The specific component properties.
Methods
The specific component methods.
Inherited Properties
The inherited properties.
Inherited Methods
The inherited methods.

Additional Proposal

  • For accessibility and to improve the learning curve (RE what the icons mean), all links should use the title attribute. The title value could follow something like, [Inherited] <property-name>.
  • The Legend section could be moved to the top of the page. Maybe a collapsible component.
@tsonevn tsonevn transferred this issue from NativeScript/NativeScript Sep 30, 2019
@rigor789
Copy link
Member

@rigor789 rigor789 commented Jun 6, 2020

There's a filter on the top right of the API docs to only show public/own methods/properties!

image

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Linked pull requests

Successfully merging a pull request may close this issue.

None yet
3 participants
You can’t perform that action at this time.