-
-
Notifications
You must be signed in to change notification settings - Fork 559
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
Better UX for listing #31
Comments
I wrote earlier this year a few words about "APIverse", an offspring of thingiverse.com. APIverse would be the place to share API specs much like thingiverse is for sharing digital 3d printable files. http://apisuomi.fi/2015/09/apiverse-thingiverse-for-apis/ |
@kyyberi I read your article and it's very similar to what I had in my mind as roadmap for this project. |
@kyyberi About UX for this project, I totally agree that it require some simple UX. About framework I prefered to do it KISS style. |
Excellent! I'm currently on vacation and return to more active state after New Year. Let's fix a date for online meeting via email. I'll contact you to start a thread. |
@kyyberi 👍 |
@kyyberi Happy holidays 🎄 🎅 ⛄ |
@kyyberi I added new banner in SVG format you can use it in your UX: |
ok, thanks @IvanGoncharov. In use now. |
Good point. Although I'm using https://apis-guru.github.io/api-models/apis.json for all the information. Reading all specs just to list items would be overkill IMHO. Perhaps the backgroundColor property could be added to apis.json listing? |
@kyyberi Yes I can extend I think it simplify usage flow for many potential clients because you need to present both catalog view with all APIs and individual API when user click on it. As bonus feature in my API I group different versions of same API and also mark |
@kyyberi But I totally open for discussion if you know some cons of this approach. |
Your API approach seems legit. |
Hi @kyyberi I liked idea of UI so much that I asked @yegorov-andrey to help me. |
This looks great Ivan! One small nit - Bootstrap's cols should always be wrapped in rows. This is Bobby Brennan On Wed, Feb 10, 2016 at 7:22 PM, Ivan Goncharov notifications@github.com
|
Hei On ke, 2016-02-10 at 16:22 -0800, Ivan Goncharov wrote:
|
Hi, @bobby-brennan |
@bobby-brennan, tried to change |
Thanks! Here's what I mean: APIs-guru/APIs-guru.github.io#1 Haven't tested, but that should get everything lined up nicely. Bobby Brennan On Thu, Feb 11, 2016 at 2:50 PM, yegorov-andrey notifications@github.com
|
Thanks @bobby-brennan! |
Aligned footer width with header width. |
I think @yegorov-andrey done a good job in implementing feature requested in this issue. |
Github is nice but UX in this case is not the ideal IMHO. I did experimental listing of APIs with jQuery. Not fully implemented or too fancy, contains bugs and error handling etc but something like this would make browsing and discoverability a little better.
http://apisuomi.fi:8080/apis/apis.guru/
If such (average) human readable front is created, it might make sense to use some lightweight JS framework.
The text was updated successfully, but these errors were encountered: