#wordpress 2018-04-23

2018-04-23 UTC
[eddie], [mrkrndvs], tantek, [chrisaldrich], [pfefferle], [kevinmarks], schmarty1, Jack, Cathie and [jgmac1106] joined the channel
#
[jgmac1106]
@gwg I am happy to help where I can but my php and Wordpress Core skills are no where near whee you need. I can help with style for now but I am going through your issues and plug-ins
#
[jgmac1106]
I also suggest looking at different computer science clubs as well as sponsorships from hosting companies
#
GWG
[jgmac1106]: The biggest issues that don't require skill per se right now are documentation and user experience
#
[jgmac1106]
there I can help out the most. Are the documentation needs well documented? If there isn't a "documentation" tag (wouldn't expect it) I can meet up with you for a video conference and just make a punch list of documentation priorities
#
GWG
The first question is if the user settings and usage are clear
#
[jgmac1106]
....which takes a cognitive lab and some willing guinea pigs for "think alouds." May have to grab the next few folks showing interest #indieweb WP and see if they will do a walk through of their install with me. is there a repo where these efforts would best be tracked?
#
GWG
Each plugin has a repo. I'm not sure if we have one appropriate for all the plugins combined
#
[jgmac1106]
Okay will work off GitHub for now and then file relevant issues in each repo. The other idea is to make a "meta"-repo that links to each of the indieweb WP plug-in repo or just keep links on the wordpress projects page of the wiki,
#
GWG
The Indieweb plugin does act as a plugin installer
#
[jgmac1106]
I will actually start by doing a clean install of a new instance and recording each step of turning on indieweb
[kevinmarks] joined the channel
#
[jgmac1106]
I didn't know for example the rel="me" and h-card are plug-in enabled for example. When I started these all had to be manually coded
jeremycherfas joined the channel
#
GWG
How long ago did you start?
#
[jgmac1106]
Not sure, never used the installer app? I would have to check my logs to really find out. The reason I have logos on my home page and headers though was that was the only way to get rel="me" links I do remember that
#
[jgmac1106]
heck you probably talked me through it. I could search my Twitter archives
#
[jgmac1106]
@gwg do you have a preferred video format and size? Keeping this universal now will make remixing so much easier later.
[grib], [snarfed] and [pfefferle] joined the channel
#
[pfefferle]
good morning
[jgmac1106] joined the channel
#
[jgmac1106]
@gwg will just go mp4 1920X1080 unless you think I should drop down to 720p. Will throw up raw videos on AWS until I can figure out archive.org. Will take me a few tries myself before developing a good protocol for the "think aloud" One good side effect is a lot of raw video clips (hope I don't curse a lot)
[kevinmarks] and [miklb] joined the channel
#
[miklb]
GWG I just found myself wanting to re-order the post kinds check box. Any thoughts on that?
[matthilt] and dougbeal|mb1 joined the channel
#
GWG
I've never tried to reorder
#
[jgmac1106]
will upload the video after class, but it gets obvious where pain points will be for new users and where we need documentation (inside of plug-in and on getting-started wiki page.
tantek, [grib], dougbeal|iOS and [miklb] joined the channel
#
[miklb]
I’ve done drag & drop but only using the CMB2 library
tantek, [jgmac1106] and [matthilt] joined the channel
#
[matthilt]
If I post in the WP GUI and include the tick for Bridgy to publish it for me on Twitter without a link I get a Syndication Link back on the post. If I insert code (<div><a href="https://brid.gy/publish/twitter"></a><data class="p-bridgy-omit-link" value="maybe" /></div>) into the post via function (so that it automatically posts without me having to use the WP client) I do not get a Syndication Link. Is that to be expected?
[eddie], j12t, [kevinmarks], tantek, sebsel, [jgmac1106] and gRegorLove joined the channel
#
[jgmac1106]
So folks starting to create punch list for WordPress documentation. Currently just recording my own onboarding to develop a "think aloud" protocol but already noticing some addressable pain points
#
[jgmac1106]
What would be best way to document? A new wiki page? The talk page of the getting started on WordPress article? Or a new repo entirely in GitHub to track documentation efforts?
[chrisaldrich] joined the channel
#
[chrisaldrich]
[jgmac1106] Perhaps stub a section on the /WordPress/Development page?
#
[chrisaldrich]
create a section called Documentation?
#
[chrisaldrich]
Its a start and can always be shuffled/moved; particularly if it becomes large
#
tantek
[jgmac1106]: better to document a raw list of the pain points
#
tantek
rather than try to turn it into useful "how to" documentation at the same time
#
tantek
we've needed a page like to for some time
#
tantek
other folks have blogged their pain points
chrisaldrich joined the channel
#
chrisaldrich
pain points isn't as positive a framing... putting it with Development helps to keep it in an area with a few more eyeballs towards making gradual improvements in my opinion.
#
chrisaldrich
but the point that it doesn't necessarily need to all be useful documentation either... we need the good with the bad for improvement
#
tantek
chrisaldrich, how do you put a positive framing on raw negative experiences? we also don't want to sugar coat
#
tantek
the point of collecting pain points from multiple people's experiences is to start to see patterns (hopefully) and use that to triage and decide which are the *biggest* / worst pain points that need to be solved first
[miklb] joined the channel
#
[miklb]
almost sounds like we should create a survey
#
tantek
[miklb] that would be even better, and requires more work. Starting with a raw list from folks contributing their experiences (including prior blog posts about frustrations) is a good start towards illuminating what survey questions to ask
#
chrisaldrich
I'm not saying sugar coat either, but put them in a place that's front and center for helping to improve the situation rather than simply a grousing ground... :)
#
tantek
chrisaldrich: it has much less to do with "Development" than it has to do with "UX" for example
#
chrisaldrich
Then a page for UX improvements perhaps? I think most of the pain points are generally put directly into repositories where they're usually remedied more quickly.
#
[miklb]
didn’t we create a generic repo for issues? Am I imagining that?
#
chrisaldrich
miklb, I thought there was too...
#
Loqi
[indieweb] wordpress-feature-requests: An issue tracker for general requests for the WordPress IndieWeb plugin ecosystem.
#
chrisaldrich
maintaining additional pages for these types of issues on the wiki isn't very DRY, and likely won't be as looked at/front-and-center as in the repos as issues.
#
[miklb]
it definitely will get my attention more in repos vs wiki
#
tantek
chrisaldrich: yes, better to have them in the repos as issues, however that's also extra work for the person reporting the issues, to figure out which repo / where to file which issue
#
tantek
having an input funnel would help gather that feedback
#
tantek
and some feedback could be systemic
#
chrisaldrich
jgmac1106's earlier comment was a Documentation focused in addition to looking at pain points.
#
tantek
like where do you propose tracking the "one super indieweb plugin" vs. "lots of little incremental indieweb plugins" issue?
#
[miklb]
I believe there is an open issue for that in the indieweb plugin repo
#
chrisaldrich
some of those issues come down to people actually writing the code and I think they are more than well documented for people who are likely to work or want to work on them.
#
[miklb]
the discussion seems to be shifting towards compiling some of the plugins amongst the developers who create & maintain them. I respect their discussion and think we should let that play out before throwing more stuff against the wall. If that goes through, then a lot of the discussion becomes moot.
#
tantek
[miklb] makes sense, thanks for the summary
#
[miklb]
and then we can refocus on the UX
#
[miklb]
that’s not to say a user survey of some sort and continuing to work on and solicit help with documentation wouldn’t be beneficial
#
chrisaldrich
yes, we still need some respect for the indie part of things ;)
#
tantek
yes, hoping we can do both in parallel, e.g. providing [jgmac1106] a place to document his observations since he's doing the "clean install experience"
#
tantek
perhaps that's a form of onboarding research?
#
tantek
what is onboarding
#
Loqi
Onboarding refers to the first experience a user has when first installing, logging into, configuring, and using a new site or application https://indieweb.org/onboarding
#
[miklb]
We might want to ping the developers to open issues for what features they don’t feel are documented well enough and could use help with.
#
chrisaldrich
it might be worth stubbing out a survey certainly...
#
tantek
what is WordPress onboarding?
#
Loqi
It looks like we don't have a page for "WordPress onboarding" yet. Would you like to create it? (Or just say "WordPress onboarding is ____", a sentence describing the term)
#
GWG
I missed some fun
#
tantek
chrisaldrich: to your point, is it worth creating a /WordPress/Onboarding to document the WordPress IndieWeb onboarding experience? or is that already /WordPress/Getting_Started ?
#
chrisaldrich
Potentially, though I think the getting started page needs an additional reworking geared more toward Gen2+
#
[miklb]
WordPress/Development/Getting_Started and leave that for gen 2+ users?
#
tantek
agreed - is it possible for Gen2+ folks to setup WordPress? or are we assuming Gen2 can do some command line?
#
[miklb]
no real command line work needed to set up IW plugins in WordPress
#
tantek
or is that Gen1.5? can copy/paste simple command lines, but don't expect novel command line usage / debugging
#
tantek
[miklb]: is the assumption that someone else has already setup WordPress for them using the command line? or they are using a web host that has a one-click install/activation of WordPress?
#
[miklb]
IMO we need to draw the line between getting started with WordPress and getting started with Indieweb WordPress IMO.
#
tantek
certainly they are distinctly separate steps
#
tantek
that makes sense
#
chrisaldrich
There's a lot of IndieMark stuff which is useful for devs on that getting started page which just muddies the water for Gen2+ who are likely inundated with a lot of jargon
#
GWG
I'm happy to help.
#
tantek
chrisaldrich, and we should try to fix that upstream as well as much as possible, by making IndieMark itself less jargony
#
GWG
My plan, other than trying to rewire the audio cabling for the podcast, was to finish a settings page for the Microformats 2 plugin
#
chrisaldrich
I've got to pick up a 7 year old, but will be back in a bit... keep outlining Ideas and I'll try to stub them out later this evening....
#
GWG
I'm going to put some food up and read up
[eddie] and [jgmac1106] joined the channel
#
[jgmac1106]
[miklb] yes I started with a quick assumption folks already at level one. May throw up a quick self assessment some day
#
[jgmac1106]
[tantek] yes I do a few dry runs. I will develop a protocol and I recruited a few people who have blogged for years but never indieweb. They will hold off and let me record think alouds
#
[jgmac1106]
I am going under a no command line/limited experience as my user persona
[miklb] joined the channel
#
[miklb]
right, I’d start with the idea of someone with a one-click install on a shared host.
[tantek] joined the channel
#
[tantek]
Awesome