Agreed with Aaron. When these proposed additional APIs are actually implemented, then we can start arguing about what to call them.
I know that I personally will continue to call the API the “core web API” or sometimes just the “web API”, if it is clear based on the context in which I am talking. -- Tyler Romeo 0x405D34A7C86B42DF From: Aaron Halfaker <[email protected]> Reply: Wikimedia developers <[email protected]>> Date: August 15, 2014 at 11:05:13 To: Wikimedia developers <[email protected]>> Cc: MediaWiki API announcements & discussion <[email protected]>> Subject: Re: [Wikitech-l] [Mediawiki-api] Bikeshedding a good name for "the api.php API" As a heavy user, I generally just refer to the things api.php does as "the API". or "MediaWiki's web API" when I'm feeling verbose. I'd be confused about the "action API" since I generally use it to "read" which isn't really "action" -- even though it corresponds to "action=query" As for "the proposed REST API", I don't think that proposed things should affect the naming scheme of things we already know and love. Also, I think that all bike sheds should match the color of the house to (1) denote whose bike shed it is and (2) help tie the yard together like furniture in a living room. On Fri, Aug 15, 2014 at 3:50 PM, Sumana Harihareswara <[email protected] > wrote: > I like "action API". > > Sumana Harihareswara > Senior Technical Writer > Wikimedia Foundation > > > On Thu, Aug 14, 2014 at 5:06 PM, Brad Jorsch (Anomie) < > [email protected] > > wrote: > > > Summing up, it seems like "action API" and "api.php" are the two > > contenders. > > > > "api.php" is least likely to be confused with anything (only its own > entry > > point file). But as a name it's somewhat awkward. > > > > "action API" might be confused with the Action class and its subclasses, > > although that doesn't seem like a big deal. > > > > > > As for the rest: > > > > Just "API" is already causing confusion. Although it'll certainly > continue > > to be used in many contexts. > > > > "MediaWiki API", "Web API", and "MediaWiki web API" are liable to be > > confused with the proposed REST API, which is also supposed to be > > web-accessible and will theoretically part of MediaWiki (even though I'd > > guess it's probably going to be implemented as an -oid). "MediaWiki web > > APIs" may well grow to encompass the api.php action API, the REST API, > and > > maybe even stuff like Parsoid. > > > > "MediaWiki API" and "Core API" are liable to be confused with the various > > hooks and PHP classes used by extensions. > > > > "JSON API" wouldn't be accurate for well into the future, and would > likely > > be confused with other JSON-returning APIs such as Parsoid and maybe > REST. > > > > "Classic API" makes it sound like there's a full replacement. > > > > All the code name suggestions would be making things less clear, not > more. > > If it had started out with a code name there would be historical inertia, > > but using a code name now would just be silly. > > > > > > _______________________________________________ > > Mediawiki-api mailing list > > [email protected] > > https://lists.wikimedia.org/mailman/listinfo/mediawiki-api > > > > > _______________________________________________ > Wikitech-l mailing list > [email protected] > https://lists.wikimedia.org/mailman/listinfo/wikitech-l > _______________________________________________ Wikitech-l mailing list [email protected] https://lists.wikimedia.org/mailman/listinfo/wikitech-l
signature.asc
Description: Message signed with OpenPGP using AMPGpg
_______________________________________________ Wikitech-l mailing list [email protected] https://lists.wikimedia.org/mailman/listinfo/wikitech-l
