#dev 2017-06-18

2017-06-18 UTC
#
@WendyandCharles
ReadersGazette: BLOG Indie Author Answers by Jim Heskett http://www.thejugglingauthor.com/indieauth/ Get help writing your book #bookbloggers 94
(twitter.com/_/status/876226251983384578)
#
schmarty
tantek: thanks. /link-preview#Silo_Examples covers the main FB and Twitter examples I was thinking of. i came to the same conclusion as gRegorLove - these need to appear outside of p-name.
#
tantek
schmarty - perhaps add that discovery / conclusion somewhere in /link-preview#How_to ?
#
[miklb]
I see some WP plugins that use opengraph for the previews, but I like the idea of using XRay better. Another itch to add to my list lol
#
tantek
rather, xray as a way to test what link-previews result from various permalinks, to explore the question of how are sites avoiding link-preview propagation
#
martymcgui.re
edited /link-preview (+799) "/* brainstorming */"
(view diff)
#
schmarty
looks like /link-preview has a somewhat outdated structure. i added my display thoughts to brainstorming. don't currently trust myself to re-org the page.
#
gregorlove.com
edited /Events (+15) "archive past June events"
(view diff)
[eddie] joined the channel
#
[eddie]
Indigenous update for those following (aaronpk, cleverdevil, miklb and dougbeal in particular): I’ve been using the Alpha iOS build this past week and it’s been working great! I still need to add replies and work some interface improvements based on my experience thus far. I’m hoping to get some of that done this week and have it in an “Open” Beta via Test Flight before or by IWS.
#
[eddie]
My site has gotten a flurry of POSSE likes, reposts and bookmarks over this past week ?
#
gregorlove.com
edited /events/2016 (+8578) "/* 2016 */ archive November+December"
(view diff)
#
schmarty
updated my link-preview display render the h-cite outside the content and name: https://martymcgui.re/2017/06/13/152026/
#
Loqi
[Marty McGuire] Thanks to our guest Jeffrey Toppe for showing us the money in this week’s We Have to Ask Podcast! https://wehavetoask.com/episodes/2017-06-13-144257/
#
schmarty
?? preview lgtm. thanks, loqi.
#
gregorlove.com
created /events/2017 (+6418) "archive January-March"
(view diff)
#
gregorlove.com
edited /Events () "(-8595) /* 2016 */ remove archived 2016 events"
(view diff)
#
gregorlove.com
edited /Events () "(-6127) /* 2017 */ remove archived events, leaving last 3 months"
(view diff)
#
GWG
Trying to write a Microformats 2 plugin for WordPress is hard.
eli_oat joined the channel
#
martymcgui.re
edited /link-preview (-38) "move and update my example"
(view diff)
tantek, KevinMarks_ and [miklb] joined the channel
#
[miklb]
eddie++
#
Loqi
eddie has 8 karma in this channel (20 overall)
#
martymcgui.re
edited /User:Martymcgui.re (+831) "move around some itches, update some progress"
(view diff)
#
[miklb]
eddie how soon after do you expect to have a macOS version?
#
[eddie]
I’ll probably start on the macOS version while the iOS version is being tested. The great thing is all the classes port over, it’s just the User Interface that I have to create
#
[eddie]
I think macOS should only take about a week to do the UI given a typical week. Obviously some are more busy than others. But I would think macOS should definitely be done within 2 weeks of the beta launch of iOS
#
[miklb]
very cool.
#
martymcgui.re
edited /User:Martymcgui.re (+453) "/* Itches */ more itches"
(view diff)
eli_oat joined the channel
#
ben_thatmustbeme
this is getting annoying, trying to use indieweb/php-comments via composer, which require tantek/cassis (dev-master) which by default it doesn't like (because of min stability requirements) but i can easily fix that, butnow, apparently cassisand another laravel dependancy are both defining the function contains() and it isn't happy at all
#
tantek
uh oh
#
tantek
what is laravel?
#
Loqi
Laravel is a PHP framework https://indieweb.org/Laravel
#
tantek
let's start with at least fixing the cassis min stability requirements - which I thought were pretty liberal?
#
ben_thatmustbeme
its that the default is to require some stable version, php-comments required cassis (dev-master)
#
ben_thatmustbeme
so it looks like there are releases of cassis, yes?
#
ben_thatmustbeme
that likely means that bit is a php-comments issue
#
tantek
perhaps why (many?) frameworks use namespaces for their functions?
eli_oat joined the channel
#
ben_thatmustbeme
most php libs do
#
Loqi
[hamcrest] hamcrest-php: PHP Hamcrest implementation [Official]
#
tantek
if hamcrest has a namespace, then it shouldn't be colliding right?
#
ben_thatmustbeme
if either had a namespace then it wouldn't
#
Loqi
[ascii-soup] It's a shame that PHP doesn't have static imports in the same way Java does. However, the documentation could presumably showcase both approaches? It could even say "This is preferred, but if you don't mind polluting your global namespace with functi...
#
ben_thatmustbeme
whats really more annoying is i have no idea what function(s) from cassis php-comments even uses
#
GWG
ben_thatmustbeme: You could always try x-ray. I hear good things
#
ben_thatmustbeme
looks like the only thing it uses is ellipsize_to_word
#
tantek
that's a pretty big thing
KartikPrabhu joined the channel
#
GWG
Reading through the WordPress hook reference again, looking for ways to add mf2 automatically.
barpthewire, gRegorLove, AngeloGladding, tantek, j12t, KevinMarks and sketchess joined the channel
#
GWG
Morning
#
Loqi
guten morgen
#
Zegnat
Hi GWG
#
Zegnat
More WP work on the agenda today? Or are you about to go travelling?
#
GWG
Actually, I have to go to work. I am not traveling till Thursday when I leave for the Summit, but I have to pack and such
#
GWG
I may do some WP work when I return
#
Zegnat
Oh, for some reason I thought you were travelling early because of the early packing talks. My mistake!
#
GWG
No, I am leaving the Summit and going on a business trip afterwards, so I need to pack for a longer trip. I am packing early in case I have to buy something else
#
GWG
Yesterday did have some nice progress though on Indieweb stuff
#
Zegnat
I am keeping my fingers crossed that you are able to sneak mf2 into WP thanks to how h-entry on hentry works :) That sounds like the breakthrough needed!
#
GWG
Zegnat: I made wordpress-uf2, which is now an Indieweb organization project as of yesterday (pfefferle transferred it), my current effort.
#
Zegnat
GWG++
#
Loqi
gwg has 12 karma in this channel (235 overall)
#
GWG
I submitted the first update in two years to it last night, mostly refactoring. Assuming that the review is approved, I have more tweaks to try.
[shanehudson] and j12t joined the channel
#
loqi.me
created /iterm2 (+65) "prompted by [shanehudson] and dfn added by [shanehudson]"
(view diff)
j12t and [miklb] joined the channel
#
[miklb]
I guess tying webmentions to Jetpack isn’t the worst thing in the world, but wouldn’t be my 1st choice
#
sknebel
What is Jetpack?
#
Loqi
Jetpack is a WordPress plugin that adds many site management tools including visitor stats, security services, performance improvements, and syndication options https://indieweb.org/Jetpack
#
[miklb]
requires you to signup up at wp.com to get use, has some phone home stuff baked in
#
GWG
miklb: I don't think that is exactly the idea
#
[miklb]
oh, good, maybe I misread in my pre-coffee haze
#
GWG
Maybe I did
#
GWG
The discussion was about Jetpack Publicize working better with Indieweb stuff
#
[miklb]
I mean, the existing IW plugins are there for people who don’t want to be tied to anything like that, but if wider adoption is the goal, then Jetpack would be the key
#
Zegnat
You can’t install Jetpack without that? Even if you grab it from GitHub?
#
[miklb]
wider adoption and advancement in the mf2 & custom comment types
#
[miklb]
Zegnat, afaik, you need a wp.com authentication to fully use the plugin once installed
#
[miklb]
doesn’t use it, have only installed it for a few people
tantek joined the channel
#
GWG
I have it on some sites
#
GWG
But not on my site
#
GWG
But working with it is a good path
#
GWG
Being subsumed by it isn't
#
[miklb]
agreed
#
GWG
The issue he filed with Jetpack was local storage of POSSE URLs. Good place to start.
#
GWG
If they are stored locally, I can have them displayed.
#
GWG
So, where else can that work?
#
GWG
That integration concept
#
GWG
miklb, do you want to have a look at the PR for wordpress-uf2? I want as much input as possible as I try to get it into the org repository
#
tantek
GWG, the complementary service, storage of backfeed URLs
#
[miklb]
yes, I want to look at that today. I forked before you started a new branch and it was moved to indieweb org, so going to do a fresh checkout.
#
GWG
tantek, I don't think Jetpack does backfeed.
#
[miklb]
I’m not going to be much help with any Jetpack stuff. I have a philosophical difference of opinion of how that blurs the lines between the .org and .com of WordPress
#
GWG
Neither am I, but I'd make the effort for the next generation
#
[miklb]
I would too once the underlying concerns are addressed like custom comment types. My 2¢ is that if that gets traction, then I’d feel like there was some real buy-in
#
tantek
GWG, just as it could do POSSE, it could do backfeed, that's the point. Same social media silo access tokens and all.
#
tantek
miklb, I definitely share that concern of depending on a central service. And yet, we depend on Bridgy for much of our POSSE and backfeed in the community. Seems sensible to split that up with a wp .com service as another *option* for WordPress blogs.
#
tantek
Plus it's kinder to Bridgy as well, reducing the load/risk on it
#
[miklb]
big difference between bridgy and a for-profit business making decisions on how they are going to apply standards. but point taken
#
tantek
miklb, also a very good distinction
#
[miklb]
we’ll see how it plays out. I don’t want to get ahead of myself and be super critical and negative
#
GWG
Agreed on all counts
#
tantek
miklb haha unfortunately that's something I can very much relate to. ?
#
Loqi
awesome
#
[miklb]
I think I still have some old wounds from the initial .com split so it’s easy to go there
#
tantek
miklb, alternatively, perhaps there's an opportunity to start a clone of Bridgy that is specifically catered to be easy to setup with wordpress (.org)
#
tantek
having another indie service like that (in addition to Brid.gy - the site) would also help in similar ways
#
[miklb]
tantek, yes, I would much rather see some benevolent sponsor spin up a second version than build something new
j12t, ClonedZegnat and [eddie] joined the channel
#
[eddie]
Not sure if this is the right channel, but wanted to follow up on some Wiki vs. Blog Posts vs. Website for IndieWeb on boarding.
#
[eddie]
There was some prompting convo in #indieweb and a couple of comments in #chat but I don't want this comment to be ephemeral.
#
[eddie]
As a somewhat recent (but extremely technical minded) onboarded IndieWebber, I definitely think the Wiki is a lot to face as a newbie. I remembered hopping around and kind of searching for what I wanted. It definitely wasn't a smooth onboarding
#
[eddie]
I think something like having IndieWeb.org be a static website, with the wiki being the collaborative community might be an interesting direction
#
[eddie]
As thoughts on the Wiki were refined they could be turned into "Blog Posts/Article Pages" on a site that introduced concepts and directed people for "'more information" to the Wiki
#
[eddie]
The "website" would be aimed at all generations with the understanding that the Wiki would likely be Gen 1/2
#
tantek
eddie, while sensible in theory, the problem is we not enough people contribute to even just the wiki, to be able to keep *another* site (static or otherwise) up to date
#
tantek
I'd rather we incrementally keep improving the wiki to be aimed all generations
#
tantek
including updating the home page, and pages it links to, accordingly
#
[eddie]
Tantek: That's fair. I wonder if the info needed for onboarding would be less changing that info on the wiki?
#
tantek
because devs (or gen 1/2) will always be able to search / dig for what they need
#
sknebel
at least for general things, it seems like the good material is in external blogposts that don't feed back into the wiki. that's something we could try to fix
#
[eddie]
sknebel: exactly
#
sknebel
a bit more seperation between the dev-stuff and the "outside presentation" might be helpful, not sure how to implement it best
#
sknebel
that has come up in basically every discussion mentioning the wiki I've been in
#
[miklb]
I think a jekyll site hosted on github could pull in relevant parts from the wiki and allow web editing to minimize the work
#
Zegnat
As sknebel reminded me, calumryan had started on a thing in Nürnberg already
#
[eddie]
I think that's definitely the goal. I'm not as focused on the exact implementation but having a "nice lobby" for new people
#
[eddie]
I think utilizing blog posts that we well written and "reposted" to the IndieWeb site would be a potential
#
tantek
miklb, how would that be less work than just web editing the wiki directly?
#
[eddie]
tantek: wikis look and feel technical
#
tantek
eddie, 100% agreed with having a "nice lobby" for new people. the home page of indieweb.org should absolutely be that
#
tantek
eddie, which is why we redesigned the home page accordingly last year. we can iterate with it, and other pages too
#
[miklb]
tantek people are saying the wiki isn’t effective, and there are limitations. There could be jekyll scripts to automatically update the latest homebrew/IWC info, which minimizes work
#
Zegnat
I think there is a general problem with wiki syntax. Some of the things I picked up this afternoon are 1) wiki pages read a lot like notebooks, 2) presentation is cramped and not reader friendly, 3) there are too many links for people to follow a clear path
#
Zegnat
Especially point 3 might be hard to fix, there will be a conflict between gen1/2 users who want to be able to click for details, and gen3/4 users who only want links they are expected to click
#
tantek
miklb, the events discussion is big enough on its own - if that's the biggest problem
#
sknebel
which you in principle can solve on top of the wiki (just don't make pages like that), but it's pretty much wiki culture to not do that
#
tantek
Zegnat, all those 1,2,3 critiques about the wiki are true because its community contributed and would be true with any tool, jekyll or otherwise
#
tantek
that's the biggest misconception
#
[miklb]
tantek, not biggest problem, just pointing out one way could reduce some work while improving the introduction to new users
#
tantek
it's not about the tool
#
[eddie]
With a Jekyll github site or something similar would allow nice UI/UX from scratch with easy CSS edits that wouldn't impact the entire wiki
#
tantek
eddie, the wiki supports per page CSS edits
#
tantek
this "jekyll will solve everything" is a common misconception
#
tantek
it really has nothing to do with the tool
#
[miklb]
Reason I suggest Jekyll is there is some prior art for Jekyll being used with IndieWeb and it can be hosted on GH with web editing.
#
sknebel
it could be a wiki or wiki namespace as well
#
tantek
it is about the ability and time of the community to contribute 1) good writing, 2) good design
#
sknebel
IMHO the primary point is the seperation
#
tantek
it has nothing to do with the tool
#
[eddie]
tantek: that's fair.
#
tantek
it's missing the point to think creating a new tool / site would change that
#
[eddie]
I think visual separation, good writing and good design are definitely be 3 keys
#
tantek
people's time and ability is people's time and ability
#
[eddie]
I definitely agree the tool itself is less important
#
tantek
that's the key to be worked on
#
tantek
not just "a tool". that's a distraction
#
[miklb]
I disagree tantek. I loathe wiki syntax and editing it, thus I’m less inclined to contribute. I would contribute markdown content and help manage a jekyll site.
#
sknebel
and for some with useful abilities editing the wiki is the thing they won't do
#
tantek
because changing / adding a tool is easy. changin community work is hard
#
tantek
miklb, the markdown vs wiki syntax thing is a bit a of wash
#
sknebel
several people have told me that they won't work with the wiki unless absolutely required
#
tantek
both are content editing barriers
#
[eddie]
I agree with miklb: I would be much more inclined to help convert wiki info to nicely formatted articles than edit and update wiki. Just experience and comfort ability
#
tantek
some like one more than the other, it really makes very little difference
#
[miklb]
a wash for who? I just said I loathe wiki syntax and editing wiki pages
#
[miklb]
No one is suggesting replacing the wiki
#
tantek
and again, focusing on syntax misses the key problems
#
tantek
limited time and ability for the community to contribute content & design
#
[eddie]
syntax impacts participation
#
tantek
that is the key
#
tantek
eddie, both ways. and many don't care for markdown
#
[eddie]
If you leave the wiki you keep the existing base
#
[miklb]
but if you are forcing people to use mediawiki, which is what you are suggesting, you are eliminating willing participants, how does that help?
#
tantek
also, the fundamental problem is splitting across two sites will *dilute* that limited time and ability
#
tantek
likely making both worse
#
[eddie]
But by adding a different approach for the "lobby" you could get new blood like miklb and I potentially adding to it
#
[miklb]
or doubling the contributions
#
[eddie]
miklb++
#
Loqi
miklb has 4 karma in this channel (34 overall)
#
tantek
"help convert wiki info to nicely formatted articles " <-- you can already do this by starting a new wiki page accordingly
#
[eddie]
My thoughts exactly
#
[eddie]
except Wiki is very much out of my comfort zone
#
[miklb]
tantek, which part of us saying we are not inclined to do that isn’t resonating?
#
tantek
miklb if it really is about the syntax you can literally write wiki pages in plain text
#
tantek
and others will help format them
#
tantek
you can start new wiki pages from scratch in plain text
#
[miklb]
OK, this isn’t a hill I want to die on. I know from last year tantek is diametrically opposed to anything other than a wiki, so I’ve shared my thoughts and will let it rest
#
schmarty
one thing that trips me up when i want to put things on the wiki is i often don't have a clear idea of where to put something.
#
tantek
I say mediawiki vs markdown syntax is a wash because Wikipedia has a massive # of (mostly non-dev) contributors worldwide, while github (primary use of markdown) also has a massive # of (mostly dev) contributors worldwide
#
tantek
schmarty, you can always put something as a sub-page under your User: page to capture / develop it
#
tantek
and when it feels like a good enough "draft" to you, ask if you're not sure, someone else will likely have an idea
#
[miklb]
who are these “someones”?
#
tantek
miklb, some people like to write content, some design, some organize
#
tantek
here in the community, people all contribute different expertise
#
tantek
according to their ability and time
#
schmarty
tantek: that is a good idea. i wonder if that process is documented on the wiki... :}
#
tantek
miklb what I'm not convinced of is how a *second* site will help (and not hurt!)
#
tantek
schmarty - good q, I think gRegorLove has been doing it by example
#
tantek
but it should go on /wikify
#
tantek
what is wikify?
#
Loqi
wikifying is the practice of putting stuff on the wiki, or something in particular on the wiki https://indieweb.org/wikify
#
tantek
schmarty can you rephrase that (where to put it) as a question and add to /wikify#FAQ ?
#
[miklb]
it will help because it will be more accessible to onboarding for one. And if done smartly, it wouldn’t be so much a second site but a more accessible access point to the content on the wiki.
#
schmarty
reading through /wikify now
#
[miklb]
Then less effort could be put into “styling” wiki content, and it be used for capturing ideas/data and then presented in more accessible way. Also think of it this way, you could download the jekyll site and offline docs!
#
tantek
miklb initial setup is not the problem. maintenance and updating over *years* is the problem.
#
tantek
lots of static sites start that way, nearly none of them are actually maintained
#
tantek
in practice
#
tantek
optimizing for minimize upkeep costs / time etc. is far more important than upfront static prettiness
#
[miklb]
but if the static site is just an extension of the wiki, with willing contributors now, what is the real harm?
#
tantek
because that rarely ages well
#
sknebel
one argument for second namespace is that making easier to understand variants of sites quite often involves hiding tons of existing content - so you either create parallel pages for new stuff (with discovery issues), or you move existing content "out of the way", which makes that harder to reach and means messing with stuff other people did. and potentially decreaes usabiltiy for gen1
#
tantek
sknebel, we can already do that, starting from the home page, and as I said, there's already quite a lot of agreement to do so with it
#
schmarty
after a skim, i think /wikify does a really great job of capturing the behaviors i've seen re: making new pages, refining pages to have more and clearer content, and improving their accessibility (in terms of short/clear high level definitions before deep technical talk)
#
tantek
the problem with adding any number of namespaces is that it doubles, triples, etc. the very problem schmarty brought up
#
tantek
"where do I put something?"
#
tantek
with a new site, that makes it worse
#
tantek
and means both are less maintained
#
tantek
so everything suffers - that's the real harm
#
schmarty
i have noticed some other behaviors that might be worth capturing on /wikify recently
#
tantek
schmarty - go for it!
#
schmarty
for example, the reorganization of /micropub
#
schmarty
and attempts to update /timeline
#
tantek
schmarty - indeed, though both of those are very special purpose. to be clear, still worth documenting on /wikify (perhaps as "special kinds of pages"?)
#
schmarty
i am not sure how to capture it because it is something i have only witnessed a couple of times.
#
tantek
schmarty, add a "Exceptional Pages" heading and go for it
#
tantek
or even "Special Case Pages"
#
tantek
I'll leave the microcopy up to your preference
#
tantek
but that at least gives you a place to capture what you've observed
#
tantek
^^^ miklb this is an example, one person wants to contribute content, has time to do so, another can help with the "where", who has time / ideas on organization but not for adding more content (right now).
#
schmarty
i wonder if it will always be special case. i almost think of it like refactoring something that worked for gen1 to make it more accessible for later gens.
#
tantek
with a wiki, it's a little back/forth in chat like that and that's it
#
tantek
no issues / push / pull etc.
#
tantek
schmarty, it can start as special case, until patterns emerge
#
schmarty
there's a lot to re-read and capture so i think i will start by documenting this in a sub-page of my user-page and test out that flow :D
#
tantek
and then those patterns can be documented
#
[miklb]
horse and buggies were considered easy and popular at one point too
#
schmarty
[miklb]: i am not clear on how the analogy maps to this case
#
[miklb]
schmarty, tantek’s argument “no issues/ push /pull/ etc”
leg joined the channel
#
tantek
schmarty ok I'll start the subsection :)
#
[miklb]
https://jekyllrb.com/docs/home/ <- is all in a github repo
#
[miklb]
note the “improve this page” link
#
Zegnat
tantek, where is this magical CSS-per-page you mentioned?
#
tantek
Zegnat, see /Main_Page for an example
#
tantek
in short, you can always add divs with inline style attrs
#
schmarty
[miklb]: haha, i don't feel like it is a fair analogy to say horse+buggy : gas-powered automobile :: wiki+irc : github repo.
#
Loqi
hehe
#
tantek
I believe you can even add a full style sheet with <style> if necessary
#
Zegnat
I’ll have a test with <style>. If we want to have some stylistic difference between “this is an informative article” and “this is a wiki page” overloading everything with inline style attributes would be horrible syntax.
#
[miklb]
well, I’d be up for helping build a proof of concept of a static site from wiki content. Then would be less discussion of hypotheticals.
#
tantek
miklb, prototypes / proof of concepts are always helpful for a more well informed discussion
#
tantek
then we can move on from initial setup design / debates to the harder problem(s) of upkeep and maintenance
#
tantek
I believe the current home page came from one such prototype which was then re-implemented on the wiki
#
Zegnat
[miklb], calumryan started a thing in Nürnberg that might be of interest: https://github.com/calumryan/indieweb (also https://calumryan.github.io/indieweb/ )
#
Loqi
[calumryan] indieweb: All IndieWeb related stuff and source code for Introducing the IndieWeb guides
#
[miklb]
I certainly would want to avoid bikeshed discussions at this stage
#
Zegnat
[eddie], that project might be of interest to you too ^^
#
Zegnat
I think calum demod it too, so his thoughts should be available on YouTube from the stream. Demos haven’t been written on the wiki for Nürnberg :(
#
[miklb]
oh, yeah, that’s exactly what I’m talking about
#
tantek
similarly, that's why indiewebify.me is a separte site - so perhaps that's another example to look at in that regard
#
tantek
calumryan's thing is a great example of something that we could use to simplify the home page as a whole!
#
[miklb]
and I truly think that with _data files and some feed/json-fu the upcoming page could be automated from wiki data
#
tantek
miklb - the upcoming / event problem is definitely a known (and very specific problem)
#
tantek
(especially for those of us that do a lot / most of the manual editing :/ )
#
tantek.com
edited /wikifying (+1525) "Common Page Structure, Special Case Pages with a couple of examples"
(view diff)
#
[miklb]
wouldn’t it be nice to be freed from all of that work so could focus on other parts of the wiki every week?
#
tantek
schmarty: here you go - https://indieweb.org/wikifying#Special_Case_Pages feel free to expand with your thoughts!
#
tantek
miklb yes of course! but not if it makes the bottlenecks / burdens worse
#
schmarty
haha, thanks, tantek! that was very fast.
#
schmarty
for comparison, i was also working on a version of that content and had made it about as far as "Webmention". :}
#
tantek
miklb, Zegnat in addition see and add to https://indieweb.org/2017/Leaders#Site_Refresh opinions of how we could make a home page that's more accessible to all
KevinMarks_ joined the channel
#
tantek
schmarty - like I said different focus/ability/time :)
#
[eddie]
Zegnat I'll take a look at that project
#
schmarty
tantek: i also tend spend a lot of time re-reading other pages to try and match style/tone/etc. with more practice i'd probably need to do less of that.
#
[eddie]
miklb: let me know, I would be interested in assisting with any prototyping
#
schmarty
i will admit to getting anxiety about "messing up" the wiki :}
#
[miklb]
I’ll want to touch base with calumryan, so as to not duplicate work. I have a mf2 ready jekyll theme that’s pretty generic that I was going to start with, but will look closer at his work 1st.
#
[eddie]
Sounds good. I definitely want to look more at that
#
Zegnat
Calum is turning up for Leaders Summit, so I assume you would also be able to touch base with him during IWS. If he doesn’t show up on IRC earlier than that
#
tantek
schmarty, be bold (as they say on Wikipedia)
[kevinmarks] joined the channel
#
[kevinmarks]
Looking at updating and clarifying indiewebify.me seems like a productive approach
#
tantek
kevinmarks, agreed
#
tantek
I like the design ideas that calumryan is pursuing too: https://calumryan.github.io/indieweb/
#
[kevinmarks]
The other thing to think about is better tools for wiki editing - the way that loqi makes page creation and see also easier helps a lot
#
tantek
so true
j12t joined the channel
#
[miklb]
for me the wiki editor feels like when I accidentally get put into vim at the command line.
#
[kevinmarks]
Maybe there are ways to ease contribution and organising that would help miklb
KevinMarks joined the channel
#
[kevinmarks]
There is a richer mediawiki editor, and some other tools.
#
Zegnat
I think sknebel has ideas there. One of the reasons he worked on getting a bot logged in to the wiki
#
tantek
kevinmarks, "ease contribution" - I still think nothing compares to Wikipedia in terms of evidence of broad access to contribution. open to hearing other examples
#
[kevinmarks]
Maybe a micropub to new wiki subsection shim would work for certain kinds of pages
#
tantek
and organizing / UX / IA is always going to be harder
#
tantek
just look at how much process Wikipedia has had to develop for page / section organizing
#
[miklb]
but doesn’t wikipedia have an army of super zealous people who edit & format all day long?
#
tantek
"organizing" content is a fundamentally harder problem than contributing
#
tantek
miklb how do you think they grew that? that's the point, they're the biggest example of that
#
[kevinmarks]
Wikipedia also has an army of Bots editing it
#
tantek
kevinmarks that came later
#
Zegnat
[miklb], poke the right people here and you have your own formatting army ?
#
martymcgui.re
edited /wikifying (+644) "/* Special Case Pages */ add cross-generation pages"
(view diff)
#
tantek
Zegnat, great rephrasing of "just add plain text and someone will help format it" :)
#
[miklb]
Zegnat, as long as this is what I see when I go to edit a page, I won’t be contributing much https://cdn.miklb.com/Editing_site-deaths_section_-_IndieWeb_2017-06-18_12-22-24.png
#
tantek
miklb - how is that any different than markdown syntax except one tribe vs another?
KevinMarks_ joined the channel
#
[kevinmarks]
Site deaths is a good example of a page that could have a simpler UI to add examples
#
schmarty
tantek: i think i captured what i was thinking re: organizing wiki content to be friendly to later generations - https://indieweb.org/wikifying#Cross-Generation_Pages
#
tantek
kevinmarks, simpler than a nested list?
#
tantek
suggestions welcome if you can improve on that
[chrisaldrich] joined the channel
#
[chrisaldrich]
Someone's linked this conversation to the /wiki page right? (I'm on my cell atm or I would.)
#
tantek
(every page "could" have a simpler UI to add examples, that's not a novel observation, frankly) concrete suggestions welcome
sebsel joined the channel
#
Zegnat
We could do something like the event page does with the one-day-event template. Abstract the bullet point most to just fixed data that needs filling.
#
Zegnat
But that is a dangerous precedent. Soon you'll have revised for everything
#
[kevinmarks]
A loqi syntax for adding a new site death link perhaps, or a micropub endpoint for site deaths.
#
Loqi
a loqi syntax for adding a new site death link perhaps
#
tantek
Zegnat, if you can determine patterns for site-death examples, definitely welcome! start with documenting the pattern: https://indieweb.org/wikifying#Historical_Pages
#
tantek
frankly that's the harder part. creating a tool/template for those is (relatively) easier in comparison.
#
[kevinmarks]
I don't think there is a slippery slope problem, more an extra tools opportunity
#
[miklb]
tantek is has nothing to do with markdown, it is just not readable to me and feels inaccessible. Compared to say, something like this https://github.com/jekyll/jekyll/edit/master/docs/_docs/index.md
#
[kevinmarks]
Loqi is less keen on micropub
#
schmarty
ooh, good link, [chrisaldrich] !
#
tantek
miklb it is exactly to do with markdown - the common example is how ugly / unreadable markdown link syntax is
#
schmarty
https://indieweb.org/wiki has some great examples of itches and requirements
#
[chrisaldrich]
I've tinkered with templates a bit and those are usually helpful.
#
[chrisaldrich]
Things like template:citation which simple but help formatting and suggest capturing more data (like archived versions of articles) of course embedding those examples in relevant pages is key too.
#
Zegnat
Brb doing a pizza run. Will keep reading on phone
#
tantek
thanks schmarty !
#
[miklb]
tantek yes, because ‘’'[[delicious|del.icio.us]]‘’' is so much clearer than (delicious)[del.icio.us]
#
[miklb]
kevinmarks it could allow anyone to edit.
#
tantek
miklb, ironically, even just the marginal use of *fewer* punctuation chars makes it easier yes
#
schmarty
tries to resist correcting [miklb]'s markdown
#
tantek
markdown links are always which go first? parens or brackets?
#
[miklb]
heh, yes
#
tantek
wow wait did you just illustrate that problem? i don't even know md well enough to see such problems
#
tantek
just know that the ambiguity is so bad as to be inaccessible
#
[kevinmarks]
I just write html links as I know that syntax
#
tantek
miklb, point is that Wikipedia is proof that mediawiki syntax is *better* at "allow anyone to edit" than markdown
#
[miklb]
well, glad to know to I’m wrong and that mediawiki is the one true way™
#
tantek
though it's marginally better.
#
tantek
hence the point about being more of a tribal debate than anything
#
[miklb]
just know **I think** the mediawiki editor sucks and makes it impossible for me to feel comfortable editing it.
#
schmarty
any kind of markup system has a learning curve and needs supporting tools around it.
#
schmarty
i think my experience would be improved if our editing page had a more obvious "Formatting Help" link.
#
[kevinmarks]
This is why we have had wiki syntax wars forever. We're down to about 2 now.
#
schmarty
(the Editing Help link appears on the edit page. it has a link to the Formatting Help page at the bottom in its See Also section)
#
[kevinmarks]
Remember when we had moinmoin and mediawiki wikis?
#
[miklb]
I’m not talking about syntax, I’m talking about the editor itself for the record.
#
[eddie]
that is true, markup systems will never be supported for all people. I think the biggest issue from the origin of the discussion isn't as much about the language behind the editing as much as the difficulty at editing the wiki UX/IA. I think as much as we could improve the text, even a clearer user flow would help new users like when I first joined
#
[chrisaldrich]
I would suggest to people who have formatting or templating issues to completely ignore them. The harder problem is usually having people spend the time and write the content.
#
Zegnat
I thought we were down to Creole everywhere [kevinmarks], just one ?
#
[eddie]
You just end up clicking around and it's like wondering in a forest without a path
#
[chrisaldrich]
I'd suggest that people just write what they can and others will come along to "pretty" it up...
#
[miklb]
eddie totally that too.
#
[chrisaldrich]
I know that there are several who use Loqi's Thursday newsletter reminders to quickly double check formatting pieces of the puzzle.
#
schmarty
i think [eddie] is hitting on one of my big issues with the wiki - it's easy to get lost in the maze of pages.
#
tantek
chrisaldrich++ thanks for making the point about "harder problem is usually having people spend the time and write the content" exactly
#
Loqi
chrisaldrich has 8 karma in this channel (34 overall)
#
schmarty
and that's what i tried (badly) to capture on /wikify - that sometimes the wiki needs passes to identify related pages, reorganize them, and signpost things
#
tantek
schmarty - like I said, adding content is easier than organizing it, hence mazes are an inevitable result. curation & gardening is a difficult skill and only comes with practice
#
tantek
what's worse than a maze though, is a dead out-of-date static site
#
tantek
with zero updates
#
tantek
tons of "pretty" sites I could point to that have that flaw
#
tantek
appearing dead = worse than maze
#
tantek
pretty but dead statues, or a wild garden, which do you prefer?
#
[miklb]
talk about my analogy… ?
#
Zegnat
For people looking for static info about what a project is that might not be true tantek. They don't dare enter the maze but would study the museum
#
tantek
blog posts are better for dated static pretty summaries
#
tantek
at least that way they are up front about being dated / static
#
tantek
with published time etc. instead of a "static" page that implies recency
#
[chrisaldrich]
I wasn't a wiki fan 2 years ago (and still aren't, so I can comiserate with miklb), but I've gotten slightly better over time. Wikis are like democracy, it's the worst form of government except for all the rest...
#
schmarty
i think a lot of work on putting up a new site would go into organization. i'd be happy to support somebody who wants to do the organizational work by wikifying it for them.
#
[eddie]
one of the main thoughts that I have from this conversation is that while there is a lot of talk about not being monocultural, it does seem that there is a very strong mono-cultural bias to a wiki.
#
[chrisaldrich]
Personally, I've gotten better at it all by watching how gRegorLove comes in and cleans up all my mess.
#
[chrisaldrich]
gRegorLove++
#
Loqi
gregorlove has 25 karma in this channel (147 overall)
#
tantek
eddie, you could say the same about IRC, though perhaps less so with the Slack bridge
#
[eddie]
Correct, the slack bridge is exactly the chat analogy to my thoughts on web presence
#
tantek
and similarly, less so about the wiki UI, since Loqi has been incrementally enhanced to allow more and more simple wiki edits
#
schmarty
[eddie]: i think of it as centralization rather than monoculture. ;}
#
[eddie]
I wouldn't be here if it was IRC
#
[eddie]
It's not a comfortable environment for me in IRC
#
tantek
and thus yes, it's definitely something we can improve
#
Zegnat
The chat also still has a web bridge. The entire afternoons chat was coming from a browser
#
tantek
eddie, but imagine how much worse it would be if IRC / Slack both existed but were splintered
#
tantek
diverging communities
#
Zegnat
We just often forget the web bridge
#
[miklb]
who is suggesting splintering a static site from teh wiki?
#
[eddie]
That is a fair worry. It just didn't feel like a discussion
#
[eddie]
It felt like a wall
#
tantek
lots of lessons in how the IRC -> IRC web log then IRC <-> web UI then IRC <-> Slack bridge were developed
#
[chrisaldrich]
Many has been the day that I used that poor web bridge, which I'm sure is a primary point of entry for gen2+
#
tantek
miklb, the default, since limitation of time and energy, is that a second (static or otherwise) site = splintering and things getting out of date
#
tantek
see indiewebify.me for an example that has had difficulty being kept up to date
KevinMarks joined the channel
#
tantek
and that's on github - feel free to prove how easy it is to update by contributing there!
#
[miklb]
see to me, static doesn’t mean that a feed couldn’t be used to update the content
#
tantek
it's not a matter of "couldn't be" it's that to do anything like that requires energy, to design, setup, and maintain
#
[miklb]
and provide a gateway for people to contribute via markdown/GH that could be easily migrated to wiki. A bridge if you like
#
tantek
in practice that ongoing energy either doesn't exist
#
[miklb]
no more energy than what is expended on the wiki IMVO
#
tantek
or dilutes energy towards other things. sometimes new sources can be found, but that's the exception more than the rule
#
[miklb]
with a new set of contributors
#
tantek
yes that is the opportunity, agreed
#
[chrisaldrich]
Another option for people who don't like the wiki is to simply practice the indieweb principle of posting on their site first where they have ultimate control.
#
[chrisaldrich]
Then webmention "indieweb" (for superfeedr) or dump the link into chat here. (If you CC0 that post) someone will surely add it to the wiki on your behalf.
#
tantek
also "feed to update the content" <-- heck so few people here are able to even do a good /reader experience for themselves, I find it hard to believe that's any easier of a problem
#
[miklb]
my final take is cool, an opportunity to grow documentation and onboarding new users, go for it. But I am also not afraid of failure
#
tantek
chrisaldrich++ precisely
#
tantek
chrisaldrich - could I ask you to add that as an FAQ to /wikify ? e.g. "Do I have to use the wiki and mediawiki syntax?"
#
tantek
miklb, great, what do you think can be improved on indiewebify.me for starters then? use that as an example to demonstrate what you're talking about
#
[chrisaldrich]
I notice that there are few who use https://news.indieweb.org/ because of the technical hurdles, but content still manages to make it to the /news page or vice versa.
#
tantek
(especially as that site is very much aimed at cross-generational beginners getting started)
KevinMarks_ joined the channel
#
[miklb]
I didn’t realize there was anything wrong with the content there, just some parsing issues, which is an apples/oranges discussion. But if you think the content is out of date, feel free to pointing me to it. Also, that’s not a jekyll site, so I can’t speak to how we could automate any sections
#
Zegnat
chrisaldrich lack of the news listing might just be lack of blog posts
#
[miklb]
would the newsletter value decrease if it became a place to dump wiki edits/suggested posts though?
KevinMarks and KevinMarks_ joined the channel
#
Zegnat
That's literally the newsletter right now
KevinMarks_ joined the channel
#
schmarty
every week i read all those wiki edits and turn them into mouth noises
#
[miklb]
I’ve never actually read the newsletter
#
[miklb]
anyway, healthy discussion nonetheless. I’m off to work on a IW WP theme ?
#
[eddie]
tantek: page level CSS is done in the Wiki by adding <style> section within the edit page block?
j12t and scribless joined the channel
#
boffosocko.com
edited /wikifying (+1050) "Do I have to use the wiki and mediawiki syntax?"
(view diff)
#
scribless
greetings
#
scribless
I hope not to interrupt.
#
[chrisaldrich]
Zegnat I was thinking more about the differences in what is in the news.indieweb.org feed versus what is more easily posted at /news. Ideally those should be roughly equivalent (to the point that one could potentially be used to feed the other.)
#
[chrisaldrich]
Hi scribless
#
Zegnat
Honestly, I did not realise /news was a thing. Hmm
#
scribless
nice to meet 'the others'
#
[chrisaldrich]
Zegnat, or even more specifically /Posts_about_the_IndieWeb
#
Zegnat
Those could be bot based pages to be honest. Post once, put everywhere
#
[chrisaldrich]
We should have a word for that... could I suggest /POSSE? ?
#
Loqi
yea!
#
Zegnat
Lol chrisaldrich
KevinMarks joined the channel
#
[eddie]
hi scribless ?
#
sketchess
getting a flash back and remembers
KevinMarks_ joined the channel
#
sketchess
^^so that's how irc worked
Guest85111 joined the channel
#
sketchess
:)
#
sketchess
I hope my presence didn't swirl up to much dust. ;)
KevinMarks joined the channel
#
[eddie]
The conversations kind of died away an hour ago ? I think everyone went to eat or work on projects ?
#
sketchess
well I guess I am late than
#
[eddie]
lol never late, people will filter back through ?
#
sketchess
their is not much to say :)
#
[eddie]
That’s the great thing about the chatroom. People come through and chat, catch up on the logs and conversations re-ignite throughout the day
#
sketchess
but it was a wonderful first meet
KevinMarks joined the channel
#
[eddie]
Great ?
#
sketchess
welcome back sknebel
#
sknebel
thx. regarding the mention earlier: yes, the idea behind making Kaja login to the wiki was to automate some stuff, e.g. updating references to events in many places
#
sknebel
if someone has something wiki-based they want automated/an IRC shortcut for, please tell me, or add to Kaja's userpage
#
sknebel
Who is Kaja?
#
sketchess
I just sit here and watch for a little while, if do not mind.
#
sknebel
sketchess: sure, that's what most people do most of the time ;)
#
sknebel
it's been surprisingly busy today
#
sketchess
hahahaha
#
Loqi
rofl
#
[eddie]
That’s generally what I do, sketchess
#
sketchess
I probably should have warned you about me than. ;)
#
sketchess
@sknebel
#
sknebel
nah, activity is good
j12t joined the channel
#
sketchess
Sometimes I get the feeling, quiet places are getting busy when I join.
#
sketchess
And die when I leave. That's somehow strange.
#
sketchess
saw that with forum chats
#
sketchess
maybe that's just me and my feelings *lol*
#
sketchess
well past lies in the past
#
sketchess
:)
#
sketchess
future is more valuable
#
sketchess
thanks for the help today
#
sketchess
hope getting things runnig
#
sketchess
I see you around. Time to prepare dinner.
j12t joined the channel
#
Zegnat
sknebel Kaja needs a dfn on its user page! ?
#
sknebel
dfn or p-summary?
#
Zegnat
Either or
#
sknebel
Who is Kaja?
#
Zegnat
That did the trick
#
GWG
Nothing like sitting in the dark
barpthewire, KevinMarks, KevinMarks_, tantek and [miklb] joined the channel
#
[miklb]
GWG tell me more about themes being able to require plugins
#
[miklb]
once you get light that is
#
GWG
[miklb]: There's the library we used to use in the Indieweb plugin, TGM Plugin Activation, which was designed for that
#
[miklb]
was just reading a little bit about that for automatic installation.
#
[miklb]
I thought for some reason the WP theme directory wouldn’t allow that.
#
GWG
It does, I believe
#
GWG
But you can load a library conditionally also
#
[miklb]
I would much rather require and use mf2 plugin along with the the other IW plugins
#
[miklb]
could get close to a one click install with the theme requiring micropub, webmentions, semantic linkbacks, syndication links & webmentions for comments
#
[miklb]
maybe not even require micropub
#
GWG
We tried that.
#
Zegnat
[miklb], I would treat Micropub as completely separate. If people want to use Micropub clients over the WP backend that should be their choice.
#
[miklb]
Zegnat, yeah, after I typed it, realized it wasn’t really the same and required.
#
[miklb]
GWG tried it with what?
#
GWG
TGM Plugin Activation was in the Indieweb plugin
#
GWG
But in the theme no
#
[miklb]
gotcha. I’m just thinking if I now know I can require certain plugins, I don’t have to worry about writing conditionals for whether or not they exist and use the mf2 plugin for that basics of that, I can focus a little more time on ability to customize the theme.
#
[miklb]
That way, someone could install the theme, not worry about what plugins they needed to be IndieWeb ready, and get started.
#
[miklb]
Just another option to add to the mix.
#
GWG
Give it a shot
ClonedZegnat, KartikPrabhu, eli_oat and [miklb] joined the channel
#
[miklb]
well that was a short lived thought.
#
GWG
Why?
#
[miklb]
I double checked with the theme review Slack channel and was told they can not require a plugin
#
[miklb]
So either a theme that has to be manually be installed or no required plugins and in theme directory
KartikPrabhu joined the channel
#
[miklb]
I can still package mf2 in the theme though
eli_oat, [eddie], [sebsel], KevinMarks, KevinMarks_, [kevinmarks] and [miklb] joined the channel