added tags.yaml #61

sanchojaf · 2016-04-19T21:10:21Z

No description provided.

IvanGoncharov · 2016-04-19T21:15:06Z

resources/tags.yaml

+video: 
+  title: 'Video'
+  description: 'Video'  
+


@sanchojaf Little bit pedantic but please remove empty line.

IvanGoncharov · 2016-04-19T21:23:01Z

@MikeRalphson @bobby-brennan @RomanGotsiy @mittsh @oliver-xapix-io @darklynx
Please review these list.
But attach your comments only to the line in question, this allow discussing each tag separately.

RomanHotsiy · 2016-04-19T21:23:52Z

resources/tags.yaml

+  description: 'Jobs'
+lead_generation: 
+  title: 'Lead Generation'
+  description: 'Lead_Generation'


Underscore here

sanchojaf · 2016-04-19T22:20:51Z

Here others tags used for classified APIs

Affiliate
Annotation
API Management
Application
Art
Artificial Intelligence
Audio
Audio Transcription
Auth
Authentication
Auto
Automobile
Badge
Banking
Barcode
Business Intelligence
Car
City
Clothing
Cloud
Cloud Computing
Commerce
Compute
Container
Content
Creative
Currency
Data
Delivery
Diagram
Dictionary
Domain
Drink
Employment
Energy
Environment
Federal
Food
Forum
Gaming
Geo
Government
Healthcare
Hiring
Identity
Image Conversion
Image
Information
Insurance
Integration
Invoicing
Legal
Library
Local News
Machine Learning
Mapping
Media
Monitoring
Music
Network
News
People
Platform
Product
Profile
Publishing
Push Notifications
Research
Retail
Sales
Scheduling
Science
Scraping
Security
Shipping
SMS
Sports
Spreadsheet
State
Support
Task
Television
Testing
Ticket
Translate
Transportation
Travel
University
Visualization
Voice

Any consideration for evaluate if we added or not?

IvanGoncharov · 2016-04-20T07:21:58Z

@sanchojaf Let's not over do. I think it does not make sense present user with more than 50 tags.
IMHO, all tags should be seen on one screen + user shouldn't be bored reading them to the end.

Your initial commit has ~70 so it's already too much and adding more doesn't help to solve the problem.
If you come up with some alternatives which are more generic it would be helpful.
For e.g. Phone & SMS => Communication, and similar things.

sanchojaf · 2016-04-20T12:32:10Z

@IvanGoncharov, make sense for me.

RomanHotsiy · 2016-04-20T13:04:29Z

Any consideration for evaluate if we added or not?

I've looked through the list you've already provided and I believe we shouldn't add more tags there.

Your initial commit has ~70 so it's already too much

Totally agree, If consider the use case of presenting this list somewhere (e.g. in menu) then even 50 is too much. Maybe we can shrink this list down to ~30-40 tags?
There are groups of very similar tags in your commit that from my point of view should be joined together:
(this is not full list, just things I could notify quick)

Accounting, Billing, Financial, Ecommerce, Payment Processing -> Payment or eCommerce
Continuous Integration, Code Review, Developer Tools -> Developer Tools
Advertising, Marketing -> Marketing
Issue Tracking, Error tracking -> Issue Tracking
Help Desk, Customer support -> Customer support
Chat, Messaging -> Messaging
Telephony, Phone -> Telephony,
Server Monitoring, Monitoring -> Monitoring

There are a few tags that can be created from others, e.g.:

Email marketing = Marketing + Email
Cloud storage = Cloud Platform + Storage

We will have keywords to cover things that won't be covered by tags.

@sanchojaf what do you think?

sanchojaf · 2016-04-20T13:48:49Z

@RomanGotsiy I like all your suggestions +1,

only I have doubt with first group:

Accounting, Billing, Financial, Ecommerce, Payment Processing -> Payment or eCommerce

I propose the next for the this case :

Accounting, Billing, Financial -> Financial
eCommerce (keep for marketplace or others store apis)
Payment Processing -> Payment

darklynx · 2016-04-20T15:42:12Z

+1 to simplify Payment Processing => Payment

darklynx · 2016-04-20T15:45:14Z

btw, are there RESTful APIs for Storage that are not cloud? :) (skipping the difference between public and private clouds)

RomanHotsiy · 2016-04-20T15:47:58Z

@sanchojaf
Agree about eCommerce

+1 to simplify Payment Processing => Payment

I would even join Payment to Financial

darklynx · 2016-04-20T15:57:48Z

If I understand correct "financial" is about online banking, finance management, personal finances which are B2C APIs, whereas "payment" APIs are usually targeting merchants and allow them to accept online / mobile / offline payments from their customers - typically B2B APIs. They seem to me as totally different groups of API, but of course they are about money and finances.

Also I'm not sure where the trading / conversion / stock APIs would be directed. If the goal is to minimize initial list, then "financial" probably should cover anything that is money/finances/currencies etc. related...

sanchojaf · 2016-04-21T11:32:53Z

Hi,

Any general recommendation with current names?

singular vs plural? e.g: bookmarks, calendars, analytics, etc
avoid more that one word ? e.g: event_management, cloud_platform, file_management ..
change a word for a more general ? e.g: photo by image

Similar tags that should be joined together:

office | business | enterprise => business ?
developer_tools | tools => tools ?
project_management | issue_tracking | time_tracking => project_management ?

Thant is the current list that we have (~57):

accounting
analytics
backend
blogging
bookmarks
business
calendars
charting
cloud_platform
cms
collaboration
crm
customer_support
dashboard
database
developer_tools
digital_signature
ecommerce
education
email
enterprise
erp
event_management
file_management
financial
forms
hosting
iot
issue_tracking
jobs
lead_generation
location
marketing
messaging
mobile
monitoring
nlp
notifications
office
package_management
payment
personal_information_management
photos
project_management
real_estate
reference
search
sentiment_analysis
social
storage
surveys
telephony
time_tracking
tools
translation
version_control
video

IvanGoncharov · 2016-04-21T12:41:50Z

Any general recommendation with current names?

@sanchojaf Idea is to create list which:

User could look at the tag and have some expectation of what inside. For example Reference doesn't meet this criterion.
Don't describe a finite set of APIs instead add more open-ended categories. For example Translation is too specific and same goes Sentiment Analysis. If start adding this level of granularity we will have a huge amount of tags. Instead categories like Text or Machine learning describe the same APIs and much more.
- Amount of tags will grow through time some we should start from a smaller set. We can always add new tags but we can't delete existing ones.

IvanGoncharov · 2016-04-21T12:59:29Z

singular vs plural? e.g: bookmarks, calendars, analytics, etc

I think it should be decided on per case basis. For example, bookmark don't make any sense. But at the same time, offices don't make any sense either.

avoid more that one word ? e.g: event_management, cloud_platform, file_management ..

Fully agree, but it should be recommendation not rule.

change a word for a more general ? e.g: photo by image

Yes, it should be the dominating rule. But I think we should go even more generic.
phone => image => media or media content
In the other case, what is the category for GIF animation like Coub for example?

Similar tags that should be joined together:

office | business | enterprise => business ?

IMHO business is bad name, when I hear it I don't

developer_tools | tools => tools ?

I think it's too much, developer tools is generic enough.
Fully abstract categories like tools should be used only as last resort, If nothing else apply.

project_management | issue_tracking | time_tracking => project_management ?

👍

Thant is the current list that we have (~57):

@sanchojaf Please don't post list in this thread, this makes it hard to scroll/read.
You doing good job keeping PR in sync with disscussion 👍

IvanGoncharov · 2016-04-21T13:02:23Z

resources/tags.yaml

+  description: 'Backend'
+blogging: 
+  title: 'Blogging'
+  description: 'Informational site published with discrete entries'  


IMHO, blogging is part of social

oliver-xapix-io · 2016-04-23T09:39:57Z

I like your categorizations, folks! <3

MikeRalphson · 2016-04-24T13:02:16Z

resources/tags.yaml

@@ -0,0 +1,111 @@
+accounting:


Merge with Financial?

IvanGoncharov · 2016-04-26T17:21:15Z

@sanchojaf I don't like Managment it's too generic to be useful.
Instead, I propose to split managment into following:

Support + CRM part of Management => Customer relation
Calendars + Events + part of Managment => Time management
Project Managment

Everything else looks good 👍

sanchojaf · 2016-04-26T17:29:28Z

@IvanGoncharov I agree,

but I think that 'Event management' is more general that 'Time management'.

Calendars + Events + part of Management => Event Management ?

MikeRalphson · 2016-04-26T17:42:25Z

@sanchojaf @IvanGoncharov 'Event Management' sounds like corporate events / wedding planning. +1 for 'Time Management' in this context.

IvanGoncharov · 2016-04-26T18:11:46Z

I have exactly the same association as @MikeRalphson and Wikipedia agree with us:

Event management is the application of project management to the creation and development of large scale events such as festivals, conferences, ceremonies, formal parties, concerts, or conventions.

As for Time manegment Wikipedia says:

Time management is the act or process of planning and exercising conscious control over the amount of time spent on specific activities, especially to increase effectiveness, efficiency or productivity.

Which is also not ideal, but I can't think of anything better.

sanchojaf · 2016-04-26T18:19:01Z

@IvanGoncharov @MikeRalphson agree, I added 'Time managment' tag.

IvanGoncharov · 2016-04-26T18:21:52Z

@sanchojaf Please remove Calendars and Events.

IvanGoncharov · 2016-04-26T18:27:33Z

Everything else looks good for me.
@sanchojaf Could you please sqash all commits in one.
And let's wait untill tomorow to give other people time to review final version.

sanchojaf · 2016-04-26T19:34:07Z

@IvanGoncharov done, sqashed all commits in one

IvanGoncharov · 2016-04-26T19:51:41Z

@sanchojaf Thank you.

If anyone can show just cause why this PR cannot lawfully be merged into master, let them speak now or forever hold their peace

IvanGoncharov reviewed Apr 19, 2016
View reviewed changes

resources/tags.yaml

video:

title: 'Video'

description: 'Video'

Copy link

Member

IvanGoncharov Apr 19, 2016

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@sanchojaf Little bit pedantic but please remove empty line.

sanchojaf mentioned this pull request Apr 19, 2016

Create tags/categories for APIs #54

Closed

RomanHotsiy reviewed Apr 19, 2016
View reviewed changes

IvanGoncharov reviewed Apr 21, 2016
View reviewed changes

MikeRalphson reviewed Apr 24, 2016
View reviewed changes

resources/tags.yaml

@@ -0,0 +1,111 @@

accounting:

Copy link

Collaborator

MikeRalphson Apr 24, 2016

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Merge with Financial?

IvanGoncharov changed the title ~~added tags.json~~ added tags.yaml Apr 26, 2016

added tags.json

d5fe857

sanchojaf force-pushed the master branch from 663fb92 to d5fe857 Compare April 26, 2016 19:33

IvanGoncharov merged commit 19b327e into APIs-guru:master Apr 27, 2016

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

added tags.yaml #61

added tags.yaml #61

sanchojaf commented Apr 19, 2016

IvanGoncharov Apr 19, 2016

IvanGoncharov commented Apr 19, 2016

RomanHotsiy Apr 19, 2016

sanchojaf commented Apr 19, 2016

IvanGoncharov commented Apr 20, 2016

sanchojaf commented Apr 20, 2016

RomanHotsiy commented Apr 20, 2016 •

edited

sanchojaf commented Apr 20, 2016

darklynx commented Apr 20, 2016

darklynx commented Apr 20, 2016 •

edited

RomanHotsiy commented Apr 20, 2016 •

edited

darklynx commented Apr 20, 2016 •

edited

sanchojaf commented Apr 21, 2016

IvanGoncharov commented Apr 21, 2016 •

edited

IvanGoncharov commented Apr 21, 2016

IvanGoncharov Apr 21, 2016 •

edited

oliver-xapix-io commented Apr 23, 2016

MikeRalphson Apr 24, 2016

IvanGoncharov commented Apr 26, 2016

sanchojaf commented Apr 26, 2016

MikeRalphson commented Apr 26, 2016

IvanGoncharov commented Apr 26, 2016

sanchojaf commented Apr 26, 2016

IvanGoncharov commented Apr 26, 2016

IvanGoncharov commented Apr 26, 2016

sanchojaf commented Apr 26, 2016

IvanGoncharov commented Apr 26, 2016

added tags.yaml #61

added tags.yaml #61

Conversation

sanchojaf commented Apr 19, 2016

IvanGoncharov Apr 19, 2016

Choose a reason for hiding this comment

IvanGoncharov commented Apr 19, 2016

RomanHotsiy Apr 19, 2016

Choose a reason for hiding this comment

sanchojaf commented Apr 19, 2016

IvanGoncharov commented Apr 20, 2016

sanchojaf commented Apr 20, 2016

RomanHotsiy commented Apr 20, 2016 • edited

sanchojaf commented Apr 20, 2016

darklynx commented Apr 20, 2016

darklynx commented Apr 20, 2016 • edited

RomanHotsiy commented Apr 20, 2016 • edited

darklynx commented Apr 20, 2016 • edited

sanchojaf commented Apr 21, 2016

IvanGoncharov commented Apr 21, 2016 • edited

IvanGoncharov commented Apr 21, 2016

IvanGoncharov Apr 21, 2016 • edited

Choose a reason for hiding this comment

oliver-xapix-io commented Apr 23, 2016

MikeRalphson Apr 24, 2016

Choose a reason for hiding this comment

IvanGoncharov commented Apr 26, 2016

sanchojaf commented Apr 26, 2016

MikeRalphson commented Apr 26, 2016

IvanGoncharov commented Apr 26, 2016

sanchojaf commented Apr 26, 2016

IvanGoncharov commented Apr 26, 2016

IvanGoncharov commented Apr 26, 2016

sanchojaf commented Apr 26, 2016

IvanGoncharov commented Apr 26, 2016

RomanHotsiy commented Apr 20, 2016 •

edited

darklynx commented Apr 20, 2016 •

edited

RomanHotsiy commented Apr 20, 2016 •

edited

darklynx commented Apr 20, 2016 •

edited

IvanGoncharov commented Apr 21, 2016 •

edited

IvanGoncharov Apr 21, 2016 •

edited