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

Selection of API categories #1026

Closed
Nazarah opened this issue Jun 2, 2016 · 10 comments
Closed

Selection of API categories #1026

Nazarah opened this issue Jun 2, 2016 · 10 comments
Assignees
Labels
Milestone

Comments

@Nazarah
Copy link
Contributor

Nazarah commented Jun 2, 2016

API needs to be filtered or sorted according to their functionality and purpose.
Need to have a set of categories selected.

@Nazarah
Copy link
Contributor Author

Nazarah commented Jun 2, 2016

@philippeluickx : would you like to co-pilot?

@philippeluickx
Copy link
Contributor

Sure thing, next Tuesday?

@Nazarah
Copy link
Contributor Author

Nazarah commented Jun 2, 2016

👍

@kyyberi
Copy link

kyyberi commented Jun 2, 2016

Categories do not work when amount of APIs is high. That can be seen for example in programmableweb.com. Exploring other options might be good.

@kyyberi
Copy link

kyyberi commented Jun 2, 2016

Using multiple tags instead of distinct categories is brilliant. It serves the complex reality of APIs, where very few APIs belong in one category only. Putting APIs in multiple categories causes other UX issues. Furthermore, it probably makes it a lot easier to develop algorithms for suggestions and relatedness

@kyyberi
Copy link

kyyberi commented Jun 2, 2016

Better yet, explore option to utilize AI to build maps (relations etc) of APIs. Watson understands English: input API meta data -> utilize results.

@philippeluickx
Copy link
Contributor

+1 on Jarko's ideas. Generally pre-defined categories lead to bad design and experience. Free tags would be best, but I would add an autocomplete (at least) when adding tags. Maybe also have a suggest feature or display the most used ones.

@Nazarah
Copy link
Contributor Author

Nazarah commented Jun 6, 2016

I am listing API categories on market mashup, IBM and programmable web.
Market mashup's sounds a reasonable list, although @kyyberi 's logic outweights this.
Categories can be populated based on a given list as well as customized ones.
However I am also considering API filtering based on the protocols they use and life phase

@bajiat bajiat added the planning label Jun 6, 2016
@bajiat bajiat added this to the Sprint 24 milestone Jun 7, 2016
@Nazarah
Copy link
Contributor Author

Nazarah commented Jun 7, 2016

Added the document listing API protocols.
https://github.com/apinf/docs/blob/master/docs/research/API%20Protocols
@philippeluickx , @kyyberi want to have a look and contribute? :)

@philippeluickx
Copy link
Contributor

Didn't even know all of them... Good docs!

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

No branches or pull requests

4 participants