#indiewebcamp 2013-09-29

2013-09-29 UTC
caseorganic, jernst_, squeakytoy, singpolyma, dpk, Nadreck and shaners joined the channel
#
bret
!tell tantek I looked over Indiemark level 1. I think it looks good! Next time we have newcomers at a hack session, I think I'll try to get them to focus on acheiving indiemark 1. The most difficult part being h-entry
#
Loqi
Ok, I'll tell him that when I see him next
squeakytoy2 joined the channel
#
caseorganic
bret: you up for an indiewebcamp dinner monday in SF?
#
caseorganic
!tell tantek you up for an indiewebcamp dinner monday in sf?
#
Loqi
Ok, I'll tell him that when I see him next
#
bret
heh :) caseorganic you driving?
#
caseorganic
bret: yes
#
caseorganic
bret: lol - no, flying in monday morning for glazed conf
#
caseorganic
bret: tons of rain here in portland
#
bret
ack, i know, didnt stop my bbqing though
#
bret
im afraid I'm not going to make it
#
bret
have a TA meeting in the morning, bleeehh
benwerd, singpolyma and squeakytoy joined the channel
#
iamshane.com
edited /Homesteading (+9) "updated indiemark score table"
(view diff)
singpolyma, jgraham909, tpinto, barneybook, wardn_, eschnou, LauraJ, andreypopp, vrypan, jschweinsberg, melvster, catsup and bnvk joined the channel
LauraJ, singpolyma, bnvk, earplugs, jschweinsberg and tpinto joined the channel
#
@Rdch97
RT @sevasev: Mau buka usaha webhosting? klik https://www.indieweb.biz/reseller-business.php Diskon 50% selama berlangganan | Hanya untuk 10 order pertama Info: sm…
(twitter.com/_/status/384314568778186752)
LauraJ joined the channel
#
@Capucinenet1
RT @MyDataLabs: 1° projet de rentrée pour l'association : traverser la manche pour rejoindre le mouvement #indieweb #ownyourdata http://t.c…
(twitter.com/_/status/384340754643955713)
barnabywalters joined the channel
#
Loqi
barnabywalters: bret left you a message on 9/28 at 2:54pm: If you have time, would you check out https://github.com/converspace/webmention/pull/26 and see what you think?
jschweinsberg joined the channel
#
@lchasen
rather than failed i would say it is BROKEN RT @rapella: "The Internet Failed." https://twitter.com/benwerd/status/383060147624353793/photo/1 #pcloud #indieweb ht @benwerd
(twitter.com/_/status/384352092015828992)
tantek joined the channel
#
Loqi
tantek: bret left you a message on 9/28 at 6:58pm: I looked over Indiemark level 1. I think it looks good! Next time we have newcomers at a hack session, I think I'll try to get them to focus on acheiving indiemark 1. The most difficult part being h-entry
#
Loqi
tantek: caseorganic left you a message on 9/28 at 7:14pm: you up for an indiewebcamp dinner monday in sf?
#
tantek
bret - interesting feedback about h-entry - what's difficult about it, and what can we do to make it easier?
#
tantek
so basically all the arguments that julien51 etc. have made about Atom being preferable to HTML for # of bytes etc. is all bollocks
#
Loqi
BASICALLY ALL THE ARGUMENTS http://loqi.me/80v
#
tantek
my home page, with 20 recent entries with hentry and h-entry, WITH a sidebar is about 1/5th the size of the equivalent Atom feed of 20 entries.
#
tantek
yes, HTML+h-entry is only 20% the size of the equivalent Atom.
#
tantek
XML feeds and formats are such crap.
#
barnabywalters
ATOM for notes violates DRY inside a DRY violating format
#
barnabywalters
DRY violation squared
#
barnabywalters
for each of your notes, the content is repeated 3x, datetime 2x and URL 2x
#
jschweinsberg
That's why I use RSS instead of ATOM. A lot of elements are optional.
#
jschweinsberg
No need to repeat the notes content inside of the title.
LauraJ and bnvk joined the channel
#
bret
tantek, its a relative difficulty. Its not that difficult, but because it involves structure and unfamiliar markup, people applying it the first time to a site would probrably have the spend the longest time reading about it, thinking about how to modify their templates, etc It seems to me. Everything else is super minimal, which is the beauty of level 1: Do these incredibly simple
#
bret
things to your site and now its indieweb friendly.
caseorganic joined the channel
#
tantek
bret - that's good to know. are there any helper tools we could develop to help folks with "their first h-entry" ?
#
bret
what about that indieready site from this years UK?
#
bret
gah, what was the url for that again
#
bret
thanks jschweinsberg, i think just having a page with all the nessisary info on it it per level would be the easiest start
#
aaronpk
yes, the validator tools are extremely important, otherwise it's impossible to know if you've completed something
#
aaronpk
also the actual indiemark page is rather text-heavy, which is good for thoroughness, but not ideal for someone just starting in
#
bret
that plus pin13 and the json formatter browser extension
#
bret
makes reading json a joy ^_^
#
aaronpk
pin13 pretty-prints the JSON already :)
#
aaronpk
but yea the jsonformatter browser extension is awesome
#
bret
i *need* the foldy arrows
caseorganic joined the channel
#
tantek
aaronpk - yeah I need to keep editing down the text of IndieMark level and achievement descriptions
dietrich joined the channel
#
tantek
have already edited them down a bunch, but further would be helpful
#
tantek
bret - the indiewebify validate hCard and hEntry features don't actually work for me
#
jschweinsberg
tantek: I doesn't work for me, too.
#
jschweinsberg
It only uses the second microformat for the h-entry validation.
#
tantek
also - hate the JS-only buttons :(
#
barnabywalters
tantek: jschweinsberg: bnvk and I are working on improving indiewebify.me
#
tantek
barnabywalters - immediate fixes - need to update level 1 to test two URLs for h-entry
#
tantek
could also do a site specific search as well for someone's URL
#
barnabywalters
tantek: two URLs? what, just give two input fields?
#
tantek
yes - 2+ posts with h-entry is a requirement for Level 1
#
tantek
or you could do permalink discovery from a home page
#
bnvk
ah, yes indiewebify, need to work on some improvements
#
bnvk
tantek: I'm at a cafe in Brighton right now where you have been before.
#
bnvk
I really love that feature in 4sq- knowing a friend has been here before
#
tantek
bnvk - indeed it's a good agregator feature
#
barnabywalters
bnvk: how do you feel about doing mf finding and validation on the server side? would allow me to move much more quickly as I’ve already implemented a lot of it in PHP before, and would expose some really useful endpoints others could use
#
bnvk
this particular cafe- The Marwood, is perhaps the most lively and welcoming cafe I've ever been to, world wide
#
bnvk
barnabywalters: sounds good to me, are you working on that right now?
#
barnabywalters
bnvk: no, working on a friend’s site now but will make a start this evening
#
bnvk
ok cool. we should coordinate our efforts so ping me when you're on the task!
#
barnabywalters
okay, will do
#
barnabywalters
actually I’m taking an interesting approach to the site I’m working on at the moment
#
barnabywalters
my friend and I worked through the structure of the site, then I asked him to put together a dropbox folder mirroring the site structure, with photos in, and text files with captions
#
tantek
wonders if he could include simple web forms on the wiki to test IndieMark various features (rather than depending on JS)
#
barnabywalters
so now I’m creating a tiny static site generator which looks over what he already did and makes a HTML site out if it
#
tantek.com
edited /IndieMark (+480) "/* To Do */ simplify descriptions, make less text"
(view diff)
#
bnvk
tantek: I don't see why simple web forms wouldn't work... but hacking MediaWiki and the UX will be a bit rough
#
tantek
bnvk - hacking MediaWiki would just be a matter of allowing <form> <input> <button> markup
#
aaronpk
simple forms on indiewebify.me would be better
#
bnvk
what about on the displaying of the MF marked up code?
#
aaronpk
if there's a form on the wiki it's going to have to post to something, what would that be?
#
bnvk
wouldn't you have load a MF parser and such?
#
tantek
bnvk - can you add action= to the forms on indiewebify.me and handle them serverside?
#
tantek
aaronpk - it doesn't have to POST, it can simply do a GET to Barnaby's endpoints
#
bnvk
I could do that... but then would have output the response in some way, right?
#
tantek
exactly
#
bnvk
what is the particular aversion to using JS?
#
tantek
bnvk - the output response is simply the same page with the output for the form that was submitted in place
#
tantek
bnvk - dependence on JS = fragility
#
tantek
shit just breaks and doesn't work for all kinds of random reasons
#
bnvk
tantek: ah, yes, that would be the most straight forward display.
#
bnvk
it's worth noting the JS up there has not really been tested, nor engineered to handle failures in a nice way
#
tantek
the short answer to "what output" is the same as if you AJAX the stuff, but just the whole page
#
tantek
bnvk - exactly, so if you support form submissions, all kinds of stuff automatically works WITHOUT more code, e.g. typing into a field and pressing return
#
tantek
never understood why developers like to TONS of extra work to reimplement proper form submissions in JS, instead of just doing the SIMPLE work of making it work *just* with HTML in the first place
spinnerin joined the channel
#
aaronpk
also more likely to work on more types of devices like from my phone
#
tantek
bnvk - what's the aversion to proper HTML form markup / submission handling?
#
tantek
it's *less* work that JS shenanigans
#
tantek
*than
#
bnvk
right, but the concept is to sort of "explain" to people how the MF data on their sites "looks" in a status update, reply, profile type way to better communicate how to use said MF data
#
tantek
bnvk - none of that needs JS
#
tantek
has anyone else gotten Sandeep's h-reader to work? http://www.sandeep.io/98
#
tantek
it just returns a blank for my home page
#
bnvk
writing PHP or JS code- there's still going to be code written to parse + display teh MF data, right?
#
aaronpk
also when things go wrong (parser crashes on unexpected tokens, etc) it's less likely to be an invisible failure if it's a regular form rather than JS magic
#
aaronpk
tantek: I think it's expecting an h-feed, rathre than a list of h-entries
#
tantek
aaronpk - I have <body class="h-feed">
#
aaronpk
oh, interesting
#
tantek
with a p-name and p-author etc.
#
tantek
based on the last time we talked about h-feed
#
aaronpk
yeah then no idea why it doesn't find it
#
tantek
does it work for you?
#
aaronpk
on my site? no, I haven't done h-feed yet
#
tantek
pretty sure I added it because Sandeep asked me to
dietrich joined the channel
#
jschweinsberg
tantek: Now it does work for your site.
#
tantek
jschweinsberg - odd - now it's returning something, but bad hrefs
caseorganic joined the channel
#
tantek
no permalinks (from u-url), no dates (dt-published dt-updated), no content (from e-content)
#
tantek
I wonder what microformats2 parser he's using
#
barnabywalters
tantek: he might be using an old version of php-mf2
#
bnvk
tantek: aaronpk: i'm not terribly opinionated about doing IndieWebify in JS as opposed to <form> + PHP parsing seems like a huge win, barnabywalters and I can work towards that instead
#
barnabywalters
we can always do fancy js progressive enhancement stuff once the basic version is built
#
bnvk
the biggest trade off for me with JS approach was being able to go through and validate each stage of IndieMark in one smooth fashion that keeps the previous validations on screen- pretty negligible
#
barnabywalters
bnvk: that can still be done
#
bnvk
yah, but that's just a lot more work :)
#
barnabywalters
not necessarily
#
bnvk
barnabywalters: if you say so :)
#
barnabywalters
so, basic version is pure HTML form submit
#
barnabywalters
then, sprinkle AJAX in to load just the results div in instead of navigating to a new page
#
bnvk
right
#
barnabywalters
URLs still all work, works without JS, but you can still smoothly scroll through and see all your results at the same time
#
tantek
barnabywalters - yes, this: "always do fancy js progressive enhancement stuff once the basic version is built"
tantek, jernst_, LauraJ, andreypopp, dietrich, caseorganic and bnvk joined the channel
#
barnabywalters
ping bnvk: having a look at indiewebify.me now
#
bnvk
barnabywalters: cool, I'll be officially back on in a lil bit- just ate and now need to walk a bit!
#
barnabywalters
cool — just going through and putting some more foundations in place
abrereton and tantek joined the channel
#
tantek
hey barnabywalters - http://indiewebify.me/ seems broken now
#
tantek
all the JS links just do nothing
#
barnabywalters
tantek: I didn’t do anything — honest :) just working locally
#
tantek
this is why web forms matter
#
tantek
because when JS fails it fails silently
#
barnabywalters
I know. working on it.
#
tantek
thank you!
tantek, eschnou, abrereton1, caseorganic, singpolyma, abrereton, lukebrooker, squeakytoy, spinnerin and ozten joined the channel
#
bret
barnabywalters, did you see the webmention PR from the other day?
#
barnabywalters
bret: I did indeed, not looked at it in detail, but I trust your jeykll abilities
#
barnabywalters
provided it’ll work when I merge it, I’ll merge it :)
#
bret
it should work, it works locally
#
barnabywalters
okay, merging
#
bret
I had to move the actual content from the readme to files called 0.1 0.2 etc
#
bret
the index populates with whatever version is set to as latest in the config
#
bret
so its a little more complicated that it used to be, not sure if people want that
#
barnabywalters
bret: http://webmention.org is broken-ish now :(
#
barnabywalters
looks like a markdown parsing issue
#
bret
ack holy cow
#
bret
git reset --hard
#
bret
reset to the commit before and then force push
#
bret
let me look into it
sandeepshetty, Guest96962 and sandeepshetty_ joined the channel
#
barnabywalters
oh hi sandeepshetty
#
sandeepshetty
hey barnabywalters
#
barnabywalters
good to see you again
#
sandeepshetty
took a break for a bit... what's happening? what did I miss?
#
barnabywalters
currently frantically trying to un-mess up webmention.org. I merged bret’s PR and it broke :( I think I fixed it, you just need to regenerate the HTML in the GH UI
#
sandeepshetty
webmention.org is broken..
#
bret
hey sandeepshetty, i converted to a jekyll site as an experiment to see if it would help with some issues with the gh-page generator, and my experiment failed XD can we undo that PR?
#
aaronpk
sandeepshetty: we'd love to be able to update webmention.org faster, moving the repo over to indieweb would mean more of us can push changes: https://github.com/converspace/webmention/issues/4
#
sandeepshetty
I'll just use the auto generator I was using before..
#
aaronpk
also welcome back sandeepshetty!
#
barnabywalters
bret: I undid the PR, sandeepshetty just needs to regenerate the HTML from the md files
#
barnabywalters
sandeepshetty: thanks :) sorry for the hassle
#
bret
barnabywalters, i will have to test that out some more
#
sandeepshetty
the auto generator is picking up the latest readme
#
sandeepshetty
which is now the one with the jekyll stuff
#
sandeepshetty
argh! and there is so much cruft now in the repo!
#
aaronpk
the changes to use jekyll are good. the point is to only have one version of the text, and let gh-pages build out the final html.
#
aaronpk
otherwise we get the source md and html out of sync quickly, it already happened
#
sandeepshetty
ideally draft should be in a branch till a version is frozen.. so you shouldn't have this problem..
#
sandeepshetty
I'm resetting head to a previous version for now so I can restore the old readme
#
barnabywalters
I thought the more common convention was to have latest (WIP) version in master and freeze versions as tags or branches
#
barnabywalters
that makes more sense from a practical POV — we can work on, and make PRs to, master without having to worry about other branches
squeakytoy joined the channel
#
sandeepshetty
the website can't show the WIP (because you need to develop against a version), the repo has the WIP.
#
barnabywalters
why shouldn’t the website show the WIP by default, and link so frozen versions?
#
barnabywalters
that’s what the W3C IIRC
#
barnabywalters
s/IIRC/do IIRC
#
Loqi
barnabywalters meant to say: that’s what the W3C do IIRC
#
aaronpk
for example this link http://tools.ietf.org/html/draft-ietf-oauth-v2 redirects to the latest draft
#
sandeepshetty
thats a frozen version... not every commit is a frozen version...
#
sandeepshetty
Right now 0.2 is not frozen..
#
aaronpk
heh good point, i don't even know how to find the in-progress work of the oauth2 drafts
#
sandeepshetty
there are still some changes to be done
#
aaronpk
well we shouldn't call it 0.2 until it's frozen then
#
sandeepshetty
that's why it's in a branch that will be merged into master when it's frozen
#
barnabywalters
tantek: you’ve got the most standards experience, what version of the spec should people see when they go to webmention.org? latest commit or latest frozen version?
#
sandeepshetty
IMO, the website should show the latest *frozen* version
#
tantek
that seems fine
#
tantek
but it only works if it keeps up
#
sandeepshetty
thats what the devs would want to build against
#
aaronpk
in that case we've gotta finish 0.2 faster
#
tantek
that's why so many standards have gone to "living" specs
#
aaronpk
it's been WIP for too long, so everyone is developing against 0.1
#
barnabywalters
that makes sense. master can still be WIP for ease of working, but gh-pages is set to whatever the latest frozen version is
#
sandeepshetty
I think ppl are devloping against v1 because that's what exists..
tantek-ipod joined the channel
#
aaronpk
right, because v2 hasn't been "frozen" yet
#
tantek-ipod
So that's the problem with freezing
#
aaronpk
that's also why oauth2 got so complicated
#
sandeepshetty
barnabywalters: I prefer working in features branches and not master..
#
tantek-ipod
When depending on freezing causes more problems than depending on live, devs switch to using live.
#
sandeepshetty
master is for forzen stuff
#
aaronpk
oauth2 draft 10 was the latest over the summer of 2010, so everybody built their APIs against that. very few have updated since then.
#
aaronpk
in the mean time the spec went to 31 drafts and is now an RFC, but nobody cares
#
tantek-ipod
Experience has shown eg with this example of webmention, that "freezing" either takes too long or can be (accidentally) held up by people being missing for a while
#
tantek-ipod
sandeepshetty:depending on a "frozen" version sounds good in theory but I practice it has been more harmful than helpful.
#
tantek-ipod
So better to have home page show latest draft with latest fixes
squeakytoy joined the channel
#
sandeepshetty
tantek-ipod: I make my living building against facebook api (a living api) and I know how badly that sucks
#
tantek
And if a specific dev wants a specific number version they can go to that specific permalink.
#
aaronpk
the "master as development" and "master as stable" is split like 50/50 between developers, it's a personal preference
#
tantek
sandeepshetty: That's a proprietary API. Standard Apis work better with live versions.
#
aaronpk
our team does all our development as master-as-development
#
sandeepshetty
master as stable works well with github autogenerators
#
sandeepshetty
and I prefer the autogenerator to the jekyll stuff because I can do it from anywhere...
#
aaronpk
github builds the jekyll site by itself, it's even more automatic
#
tantek
Also, wikis for specs work better because it takes fewer steps to edit fix save than all the github commit push deploy malarkey.
#
aaronpk
the problemw ith the autogenerator is only the repo owner can update it, and as long as it's in the converspace repo that's only you
#
sandeepshetty
using hooks?
#
bret
it autotriggers every commit
#
aaronpk
it's all built into github
#
aaronpk
github runs jekyll internally to build out the html
#
barnabywalters
so there are actually fewer steps after an initial setup cost
#
barnabywalters
commit rather than commit, regenerate
#
tantek
By commit you mean commit, push to master right?
#
barnabywalters
tantek: or, push to feature branch if you’re working that way
#
sandeepshetty
how do you selectively publish?
#
barnabywalters
I prefer as little merging as possible
#
aaronpk
you can still work on feature branches to avoid updating the live site
#
aaronpk
master is what's published to the github pages hosting
jernst_ joined the channel
#
tantek
Wiki = very little merging. Make small quick edits.
#
tantek
Less ceremony for edits means smaller more frequent edits means fewer collisions/merges.
#
barnabywalters
also *much* easier to revert edits
#
aaronpk
here's a secret: this page, https://developers.geoloqi.com/api/trigger/create is actually pulling from a mediawiki install
#
aaronpk
so we could even still publish the wiki page at webmention.org and wrap it with a simpler design if needed
#
barnabywalters
aaronpk: that TOC does look familiar ;)
andreypopp joined the channel
#
aaronpk
tho I do like the ability for discussion on github issues
#
bret
ok, I fixed the render issue
#
sandeepshetty
I prefer having a WIP branch.. because something you need to play around with stuff before you decide/freeze on stuff
#
barnabywalters
aaronpk: turns out it’s super easy to POSSE to GH issues! their API is simple and personal key auth makes authentication easy
#
sandeepshetty
bret pull request?
#
aaronpk
barnabywalters: nice! are you doing it now?
#
bret
sandeepshetty, let me clean up my branch first
#
bret
i totally botched that last PR
#
barnabywalters
aaronpk: in theory, last time I tested it it didn’t work quite right (although rely context worked perfectly), I added extra debugging for next time :)
#
barnabywalters
I might also implement issue creation by replying to a repo itself
#
aaronpk
nice, yea that's how I have it working. reply to a repo creates a new issue, reply to an issue creates a comment
#
barnabywalters
cool — didn’t realise you’d already implemented it :) is that documented anywhere? do you use it much?
#
aaronpk
I haven't used it too much yet. I think it's noted on the p3k page?
#
aaronpk
i have a few replies in my feed that are github comments though
#
barnabywalters
cool. should also be really easy to backfeed (pull in further comments). I have a half working implementation of that for twitter
#
barnabywalters
using mf2-shim
#
barnabywalters
goodnight all
#
Loqi
see you in the morning!
#
bret
sandeepshetty if you are up for trying this out again, I send you a fixed PR
#
bret
with the fixed render error.
#
sandeepshetty
bret: merged..
#
aaronpk
bret: index.html is empty. shouldn't it at least link to 0.1?
#
bret
aaronpk it isnt actually
#
bret
its a workaround for a content bug
#
bret
the layout is set to index
#
bret
check out layout/index
#
aaronpk
oh crazy
#
aaronpk
we should see it on webmention.org in a few minutes then
#
bret
bret.io/webmention is the final render, sans css
#
bret
once its on its own TLD the css works
#
bret
errr own domain
#
bret
sandeepshetty, i need to PR better, I'm so sorry
#
sandeepshetty
If we agree that the website is going to be the latest frozen version. can we just go back to not using jekyll?
#
sandeepshetty
I don't think spec repo should look so complicated: https://github.com/converspace/webmention
#
sandeepshetty
to contibtors..
#
sandeepshetty
the early version with just the readme was perfect
#
bret
whatever you guys want, i see some benefit to jekyll once its working, but for pure simplicity i can understand that as well
#
bret
this is what people will see when editing: https://github.com/bcomnes/webmention/blob/master/0.1.md
#
aaronpk
I don't think we've agreed on freezing versions yet either
#
aaronpk
in the mean time webmention.org is restored
#
sandeepshetty
Given the things that I've seen filed as issues.. if this were a wiki I think the "spec" would be pretty messed up by now...
#
aaronpk
I like having github issues to discuss this stuff
#
sandeepshetty
I thinks it's important to have some editorial control over the spec..
#
sandeepshetty
hence the role of a editor
#
aaronpk
sandeepshetty: sure, but if the editor goes off the grid for a few months then it really messes up the flow of development
#
sandeepshetty
the editor wasn't away for a few months.. and he was thiking about the spec while he was away.. getting the editor back for emergencies is just an email or tweet away
#
bret
idea!
#
bret
we can use submodules on the website
#
sandeepshetty
bret: the arbit pages is a good pro for the jekyll appraoch
#
sandeepshetty
I hare git submodules
#
bret
the cool thing is that for the website, you wont have to deal with them, I will
#
sandeepshetty
and now with composer I never to use them
#
bret
and the webmention spec can remain a readme.md file in its own repo
#
bret
shit, thats what I should have done
#
sandeepshetty
bret: how does that work?
#
aaronpk
interesting? I can't picture it
#
bret
we have a website repo that has submodules to different commits in the vanilla webmention repo
#
bret
gh pulls those in on generation
#
bret
let me try a prototype
#
bret
the website would have to be updated routinely to point to the right version of the spec though
#
sandeepshetty
the right version of the spec will always be master
#
sandeepshetty
does that make it simpler?
#
bret
I mean, its just a bunch of tradeoffs
#
bret
one readme.md is super simple, but then keeping the site in sync becomes a chore
bnvk joined the channel
#
sandeepshetty
hmm.... I have another simpler option.. I'll just remove the cname and instead just have the domain redirect to master/readme
#
aaronpk
on github.com?
#
sandeepshetty
that solves all issues ..