#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
# [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
# [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?
# [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,
# [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
# [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
[matthilt] and dougbeal|mb1 joined the channel
# [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
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?
# [jgmac1106] Okay
# [chrisaldrich] Its a start and can always be shuffled/moved; particularly if it becomes large
# tantek perhaps /WordPress/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
[miklb] joined the channel
# 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... :)
# 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.
# chrisaldrich miklb, I thought there was too...
# 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.
# chrisaldrich jgmac1106's earlier comment was a Documentation focused in addition to looking at pain points.
# 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.
# chrisaldrich yes, we still need some respect for the indie part of things ;)
# 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
# chrisaldrich it might be worth stubbing out a survey certainly...
# 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)
# 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+
# 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
# 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....
[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
[tantek] joined the channel