#jasnellok. the short version is that there was an initial hold up on the w3c side that harry described as an "HR issue", then there were a couple of html validation bugs to fix. Looks like publication is currently scheduled for this Thursday
#tantekhopes to make it to the Socialwg/Social API/Requirements discussion
#wilkieeprodrom: I went to the social IG call last week to discuss the process and present social apis to the IG. it went well
#harryNote that the archives are available as a SQL dump from drupal
#wilkieeprodrom: a very open discussion about the process that seemed helpful and there was a general agreement and approval of what we've done by the IG
#harryso someone would have to 1) reset-up drupal and 2) snapshot the blogs as HTML.
#wilkieeprodrom: one thing that did come up is that most of the APIs we reviewed were primarily US focused and it was noted we should look at networks in other parts of the world
#wilkieAnnB: yes, is there a difference between these networks. We do have members who are in China, only a few in Russia, but some may be recommended [to help]
#KevinMarkshistorically, several of them adopted opensocial and had some mapping; the differences were often about payment
#wilkieeprodrom: between a few members, most of these countries are covered. I feel like I can look at the bottom and read through the documentation so I could collaborate
#wilkieeprodrom: we identified a number of APIs throughout the web and we've looked at what they do
#wilkieeprodrom: we've looked at twitter, facebook, etc and open source pump.io, etc and some from non-specific standardization e.g. linked data platform
#wilkieeprodrom: we've covered quite a bit and our next step is gathering from these multiple apis and coming up with a set of requirements for our API
#tantekq+ to suggest a simpler approach to API *requirements*, based on a previous group resolution, vs. "nice to haves"
#wilkieeprodrom: we've talked about them a lot and documenting them online, but the time is rapidly arriving when we need to decide what these requirements are to move forward with a candidate proposal
#wilkieeprodrom: the idea is if we can approve a list of requirements, then we can start soliciting proposals and can measure the quality of the proposals based on those requirements
#wilkieeprodrom: we had a list of requirements earlier and should be updated and we should discuss if these requirements are good for upcoming proposals
#wilkieeprodrom: one thing we can do is say "great, these are fine" and move on, or we can look at these and rewrite or elaborate on them further
#wilkieeprodrom: my goal is to move the process further
#wilkiebblfish: the idea is to have an API that has all of them, and it may not be necessary for the WG to list all cases, but seeing all features together would be nice
#jasnellwould recommend that others match the requirements up against their existing implementations as well
#tantekwith all due respect, I don't think anyone is qualified to say something is "easy" unless they've already *SHIPPED* it, e.g. on their own website
#Loqisandro: ben_thatmustbeme left you a message on 1/20 at 12:26pm: i'll be co-organizing IWC Cambridge 2015, can you confirm that we have a venue for those dates? 2015-03-19/20?
#jasnellthe requirements list can be simplified and achieve the same result
#wilkieharry: tantek is saying take the minimal use case agreed upon and add to that, and evan is about developing the list of potental requirements that we can shave down
#wilkieharry: the real issue is that we don't have a draft and it is really hard to whiteboard an API draft from scratch, which is why we have done that research
#KevinMarksinstead of the superset, choose the interesection
#tantekq+ to point out the process we agreed on does not specify *HOW* to "Assemble functional requirements of a social API" https://www.w3.org/wiki/Socialwg/Social_API thus I am proposing SWAT0 for that.
#bblfishtantek. You can ask 9 implementations from the LDP group, to work out what easy is . I have built one by myself, so if one person can get implement it, that makes it easy. That's what I am basing my statement on.
#wilkieharry: it, as a superset, is quite big. to resolve the tension, if somebody wants to whiteboard the draft and looks at the requirements we have made progress and we can say "this is not necessary for swat0" or "hey I'll need this for X"
#wilkietantek: if you look at the process we agreed on (pasted the url) the first step is the requirements of the social api, and I am suggesting a concrete way of doing that:
#tantekq+ to note that IG function is to *provide* use-cases, not *approve*. The Social Web WG must approve use-cases explicitly.
#Zakimsees AnnB, harry, tantek on the speaker queue
#wilkieeprodrom: if we cannot go forward without the IG making those use cases, we'll need to ask them what their timeframe is or we do them internally in the WG
#tantekq+ to also note that I specifically said we can *start* with accepted use-cases as of today for draft API requirements, and then we can iterate with more use-case driven requirements as we approve them in the future. let's remove dependencies.
#Zakimsees AnnB, harry, tantek on the speaker queue
#wilkieeprodrom: for me, I don't think it is sufficient social api nor reaches the minimum social networking we expect from a social api
#jasnellHere's an example of a comprehensive existing social api that implements quite a lot of these requirements: http://goo.gl/801jqU
#wilkieAnnB: in regard to the usecases in the IG, which I am chairing, we have many scenarios and we have maybe too much.
#wilkieAnnB: question I have for the WG is "what would you want to see and what format would it be in" what would be the most useful way to give you [the usecases]?
#wilkieeprodrom: I think the use cases you posted are very detailed and there's a lot in here, but I think what we want is a checklist we can compare a proposal against
#wilkieeprodrom: "this proposal doesn't have a way to post content, so this isn't good for this use case"
#tantekI actually don't want a checklist - because that's again likely political rather than user-based
#Zakimsees harry, tantek, sandro on the speaker queue
#wilkieeprodrom: not sure if we can do briefer ones or if there is another way to do this. if we hold out for full user scenarios it is unlikely we can do things promptly.
#Zakimtantek, you wanted to note that IG function is to *provide* use-cases, not *approve*. The Social Web WG must approve use-cases explicitly. and to also note that I specifically said
#Zakim... we can *start* with accepted use-cases as of today for draft API requirements, and then we can iterate with more use-case driven requirements as we approve them in the future.
#wilkietantek: I think I answered Ann's question on what to provide. I do agree that IG use cases are detailed and lengthy, which is good, they need a summary of steps. much like SWAT0 that fits in a tweet
#wilkietantek: goes back to the IG: a summary of steps is what we want
#Zakimsees sandro, harry, bblfish on the speaker queue
#wilkietantek: I also agree with concerns about not a complete API and that it may take months of work to come up with usecases.
#wilkietantek: this is why we should not wait for the IG usecases but just immediately go forward with even just a small draft with the usecases we have and extend with new cases later
#KevinMarksthe assumption that completeness is necessary is how we end in the weeds
#wilkietantek: so when people come and say "I need this feature" they can make a claim upon the draft we have
#elf-pavliki'll try to write something on importance of *extensibility* for this API, this way we just provide clear path to add support for all kind of requirements which will come up down the road!
#wilkietantek: my point is that I do believe we can come up with small incremental usecases if we need to. we don't need to wait.
#wilkietantek: the IG does the work, but does not approve them. the WG approves and accepts them one at a time.
#KevinMarkscontainer is also an opensocial term of art
#tantekjasnell - and I say users do care, and thus it matters
#Zakimelf-pavlik, listening for 10 seconds I could not identify any sounds
#wilkieharry: at the same time, evan's fear that SWAT0 is not sufficient is legitimate
#jasnelltantek: and I'm saying that right now's it's not critically important that we decide what to call it.
#tantekjasnell - if you don't care, then change it to "collection"
#wilkieharry: so, let's make a draft with requirements, and mark those that are good for swat0, mark the others as such, and use that as a place for discussion
#tantekjasnell from our experience in indiewebcamp - that term resonates / explains much better
#wilkieharry: we need a place to add/subtract features and discuss these features
#tantekdon't say something is "light" or "simple" unless you've shipped it.
nicolagreco joined the channel
#harryso we should just clearly demarcate in any API what parts are necessary for SWAT0 and what isn't, as tantek said
#KevinMarkshas shipped opensocial - it wasn't that easy or simple
#wilkiebblfish: I think one or many could present how they would do things with a base api and that would allow us to make a case that one way is simpler than another
#tantekharry - exactly - thus we start the requirements bar at "necessary for SWAT0"
#tantekthey aren't *actual* requirements, because they're not *required*
#wilkiebblfish: in a usecase we could specify that is the criteria of what should be allowed
#harryI'm just suggesting that if Evan or someone else is drafting an API, they can go with functional requirements greater than SWAT0, just clearly mark those
#harryshould be pretty straightforward, i.e. contacts are needed for SWAT0
#Zakimtantek, you wanted to discuss flaws in existing APIs, lack of URLs, lack of follow-your-nose, too many special APIs just copy/pasted for different types
#wilkiejasnell: we are trying to get the context documents served up with the magic incantation sometime after
#wilkieharry: the problem is when there is an html error in a document, no matter how small, the webmaster will push back and we have to fix it before we can publish. that's how the w3c process works.
#KevinMarksso w3c is less tolerant of html errors than w3c specs?
#wilkieharry: there may be a process change that would make this process easier, but things should be set for thursday unless the webmaster finds something else
#ZakimAs of this point the attendees have been eprodrom, jasnell, KevinMarks, aaronpk, Arnaud, Ann, wilkie, bblfish, bret, rhiaro, Sandro, Lloyd_Fassett, ShaneHudson, hhalpin, tantek,
#harryOK, that makes sense - just making sure we didn't move the dates. Doing a separate indieweb camp after sounds good to me, although sadly I have to examine a Ph.D. thesis on those dates so I might not be able to make it :(