#tracydurnell[d]It didn't occur to me to ask until I already set it up, but is there a template for what should be in a popup event listing? I just adapted from past events
#capjamesg[d][tantek] "is "shoot(ing) the breeze" also an unnecessarily violent metaphor?" > I had never thought about that... I don't think we have a popular equivalent in the UK.
#[manton][tantek] Maybe I’m naive but I’m cautiously optimistic about Omicron… If it’s less deadly, might be okay that it spreads more quickly. I’m getting my booster shot today too.
#[manton]However, I do think that in-person events need to consider COVID-friendly venues. The place I’m considering in Austin for late 2022 is very open and can be partially outside. I think that will be a requirement going forward.
#[KevinMarks]less deadly is not clear yet - UK spread is fast but not worked through to hospital admissions yet, let alone deaths and SA has very different age profile from UK/US
#petermolnarthe /why page is a splinter in my toughts to be honest. I know it makes sense as is, but simultaneously I find it incredibly unreadable from a newcomer or non-tech person perspective.
#petermolnarI know it's a wiki, but it doesn't have a flow to read it
#petermolnarand I think that's my main problem, that people arrive at our wiki with the idea of reading through /why and they get immediately overwhelmed, because instead of a nicely written article they get an encyclopedia
#[tantek]1That's a natural state in the iterative evolution of wiki pages. The /why page used to have a flow to it, but over time, it grew to be more lists of things that themselves grew organically
#petermolnarI think adding a short summary in each major section with a few links to the outside world's nice articles could help.
#petermolnarso I seriously like the idea of the "Why have your own website" section with the outgoing links
#[tantek]1I agree. Each section itself should be treated like a mini-article, with a easier to read summary at the top, before diving into a detailed list
#[tantek]1This is also the challenge of figuring out both when and how to split longer pages into subpages, because rarely is it obvious how to do so, and different pages need different treatment (there's no universal "here's how you can split up every page!" that works while preserving easy access to content
#petermolnarI saw your todo: split identity loss, I fully agree with that
#[tantek]1Key is to avoid the "don't make me click 4-5 times just to read something of substance" which is usually what happens when content gets divited up
#petermolnarI might have some time in the coming weeks to start that
#[tantek]1yes, some (most?) of the /why sections are now large enough to deserve their own detailed articles, while keeping a welcoming summary and the "best links" directly in place on the /why page
#[tantek]1I'm happy to help brainstorm that btw, just not right before the newsletter goes out.
#[tantek]1maybe it was an attempt to get (mostly developers) to reframe their "problem" statement into an actual use-case
#[tantek]1since so many developer problems start with things like "so I have this server problem" or "DNS problem" or "database problem" or "CMS problem"
#[tantek]1or worse "I have this markup problem" and that's great for other discussions, but that's not an "IndieWeb problem"
#[tantek]1attempt to get folks out of default plumbing-centric thinking
#petermolnarmaybe we can recycle that redirect for some parts of /why
#edgeduchess[d]this might be more a general thought than about fixing the wiki, but if you're thinking about the newcomers flows I think there's value in thinking about what your goals are for them and actively building with those in mind
#edgeduchess[d]like, what does your ideal newcomer look like? What are their goals? How can you help them achieve them?
#edgeduchess[d]if you think about what your newcomers comes in the space seeking, and what you want them to learn in the first 15 minutes, that will help building an effective flow for newcomers onboarding
#[tantek]1edgeduchess[d], mostly we're doing all that based on actual newcomers experiences, rather than trying to answer those questions a priori. listening to people's empirical experiences rather thank "thinking about", trying to understand the diversity of actual newcomers rather than an "ideal"
#[tantek]1a lot of that top level experience/design has gone into the thinking behind the ongoing "three column" home page redesign so far
#LoqiJust generated this week's newsletter! You still have a few minutes to make changes, and I'll re-generate it 10 minutes before it gets sent out at 3pm Pacific time. https://indieweb.org/this-week/2021-12-17.html
#[tantek]1nor do they want that replaced with something that makes them feel bad because they lack sufficient "will" or don't "get" the "simple" existing tools (which none of are actually simple)
#[tantek]1edgeduchess[d], have you found successful techniques for getting more folks to understand/sympathize with the broader default desire for at least decent and preferably "nice" aesthetics?
#petermolnarmy point: there are no such tools. Not even a hammer, because even that needs practice.
#edgeduchess[d][tantek]1: I think people do sympathize with that generally, but most often those people aren't necessarily in places like this
#edgeduchess[d]I think there's certain types of devs that just will never sympathize with that, and that's ok cause they can build tools for devs rather than for end users
#edgeduchess[d]anyway, I'll tell you what I'd consider the simple guide/tool I'd like to have for myself
#edgeduchess[d]1) a list of what I'll need to implement to get my own self-hosted to ~Tumblr-levels of interactivity
#edgeduchess[d](so people can discover and comment on it)
#edgeduchess[d]2) a list of npm packages i can install in my JAMStack tool of choice to kickstart my journey
#edgeduchess[d]3) where to go to ask for help/join the community
#[tantek]1Tumblr as an indieweb-feature-set is an interesting exercise to consider
#LoqiJamstack is a web development architecture based on client-side JavaScript, reusable APIs, and prebuilt static pages served via a CDN https://indieweb.org/Jamstack
#edgeduchess[d]TBH complete NextJS e2e tooling/tutorial would be the best way to get interested devs started these days
#edgeduchess[d]but you *need* to think about their experience as users
#[tantek]1that page needs a big update for an IndieWeb-relevant definition and "How To" section
#edgeduchess[d]you kinda want to make it so they go from bringing up their website to getting their first comment on whaetever the write to be a "delightful" experience
#edgeduchess[d]like you offer a lot of tooling and choices, but you kinda need a minimum path to people being like "hey! there is a community of people here I can be part of! they'll listen to me!"
#LoqiIt looks like we don't have a page for "NextJS" yet. Would you like to create it? (Or just say "NextJS is ____", a sentence describing the term)
#capjamesg[d]I agree re: NextJS being quite big among personal sites. I used it for a while but it was too bloated / abstract for me. But many people love it and it’s good for commercial sites.
#capjamesg[d]How can that onboarding path be fleshed out [tantek]?
#capjamesg[d]I went from numerous tools — even Carrd — to NextJS to Jekyll to my own static generator.
#edgeduchess[d]capjamesg[d]: you want to go meet the dev community where it is
#[tantek]1capjamesg[d], can you create a stub page for NextJS?
#LoqiStatic site generators or SSGs are programs that take a set of flat text files on disk and transforms them into a set of static HTML files ready to be served by a standard web server, or some variation of this example https://indieweb.org/SSG
#capjamesg[d]Re: static sites, I have had a lot of success adding IndieWeb functions.
#capjamesg[d]I started by building a site then slowly added in IndieWeb features using existing tools like Webmention.I’m.
#capjamesg[d]As I built confidence I experimented with JS to add dynamic features like comments. Then I went deeper into each spec and realized I wanted to implement many of them 🙂
#capjamesg[d]What would you look for in that how to page? How to choose one?
#edgeduchess[d]also this made me think that really what you want is a good NextJS IndieWeb SSG website starter
#edgeduchess[d]Which is actually what I wanted to build for another project i have in mind
#[tantek]1capjamesg[d], look at the /CMS page for a better example
#edgeduchess[d]but it could be spun off in its own community thing
#edgeduchess[d]I count 2, because i consider the anchor to "self starter" to be one
#edgeduchess[d]and even when i get there, the info is way too buried
#[tantek]1re: "meet the dev community where it is" <-- there is no one "the" dev community, that's why we have to offer multiple paths, and hopefully in a way that people can self-direct to the path that fits their dev approach
#[tantek]1tbh first I've heard of it in this context
#capjamesg[d]Yep! That’s why I documented some of the ways in which I added IndieWeb features to my Jekyll site. And continue to do so as a static site.
#edgeduchess[d]also, if you don't syndicate with dev.to, you should do it more
#petermolnar> tools with hype and traction behind them should be prioritized and actively pursued - are you sure? Because hypes change every ~half year.
#edgeduchess[d](what I mean is you should write articles for that audience, and make sure they show up there)
#edgeduchess[d]Nah, they don't. Some things stay stable.
#edgeduchess[d]like yeah sure some stuff comes and goes
#petermolnar> Nah, they don't. Some things stay stable. - like Perl.
#edgeduchess[d]generally betting on JS tooling is the best thing to do here
#[tantek]12 years of steady growth beats that "change every ~half year" metric petermolnar
#edgeduchess[d]you pick the framework that's popular then, you can npm package a lot of stuff that's reusable across whatever comes next
#[tantek]1edgeduchess[d] really? I mean, I agree with specific tooling that seems to be picking up, however, JS framework-du-jour is an endemic problem and merits the skepticism that petermolnar is talking about
#edgeduchess[d]I think it's generally true, but I think there's big players that are an easy target
#petermolnaryou want someone from the indieweb community to package tools for react?
#edgeduchess[d]now Remix is all the new rage, and I wouldn't suggest getting onboard with it soon, but if you had done the NextJS work it'd be easily portable
#edgeduchess[d]> Websites that use React often only render on the client-side, which means they are not curlable. The only HTML in the page on the initial browser load of such sites is typically an empty body and some links to Javascript files. This means that microformats parsers are unable to see any of the content there. Websites can solve this by adding Server-Side Rendering.
#petermolnaredgeduchess[d] is recommending that someone here should pick up the task of creating indieweb nmp packages that are in theory cross-framework proof, so devs can pick it up. I'm saying nothing is stopping anyone from doing that, but it's unrealistic to expect that people will pick this up just for fun.
#petermolnaredgeduchess[d] if you know npm devs who'd like to pick this up, please involve them
#[tantek]1edgeduchess[d], appreciate the raising the points about NextJS, looks like it has come up a few times in chat over the past couple of years, and is even mentioned in a few pages: https://indieweb.org/wiki/index.php?search=NextJS
#[tantek]1^ capjamesg[d] see those search results, might be helpful when you're stubbing the NextJS page
#edgeduchess[d]I actually have full intention of doing that when i start working on my own personal website, cause I strongly believe the lack of those is an extremely low hanging fruit to get more people into the ecosystem
#[tantek]1edgeduchess[d]++ that would be awesome, and am more than happy to help link up such content so it's (more) discoverable
#Loqiedgeduchess[d] has 3 karma in this channel over the last year (6 in all channels)
#edgeduchess[d]it is part of the reason I am not in the ecosystem myself, paired with no onboarding path that works with my brain
#[tantek]1that might not even by the right framing "place for your content"
#[tantek]1however I'd like to replace the "GitHub Pages & GitLab Pages" subsection there with instead something more welcoming to SSG approaches in general, including listing NextJS by name
#edgeduchess[d]have you considered making the font size different in h3 vs h4 more dramatic?
#edgeduchess[d]here my brain can't jump from a section to the next without reading every title inbetween
#edgeduchess[d]with the previous screenshot, i can tell easily that "get a place for your content" has 3 sections, once of which is GithubPages
#edgeduchess[d]I think if you do it this way, adding another section for SSG/JS frameworks (even if you didn't want to replace GitHub pages) would visually work
#[tantek]1agreed about the "sections of the pages blend together" problem
#[tantek]1IMO GitHub pages is "just" another SSG approach so it should be subsumed accordingly
#[tantek]1I've had more success directing people to Netlify than GitHub pages recently to get started and setup their personal sites / blogs etc.
#edgeduchess[d]I think that makes sense, just be aware some people might not know what SSG is, even if they use Next
#edgeduchess[d]i did not, but i assume when i went to build it for myself I would have found it and found it useful
#edgeduchess[d]I've used similar tutotrials in the past and CSS-Tricks usually has good content
#[tantek]1I'm asking because if we can at least link to existing tutorials like that to start with, it will help provide at least a path for folks while we write more docs
#[tantek]1Since I'm not a NextJS dev, I don't know if that's a "good" article from a NextJS dev experience perspective, hence why I'm curious about your opinion of it
Seirdy joined the channel
#edgeduchess[d]anything that's good for a general webdev is also good for a nextJS dev 🙂
#edgeduchess[d]it hides the fact that it's a react framework really well
#[tantek]1that's interesting because past experience has been that "general webdev" is very much at odds with a "react mindset"
#edgeduchess[d]i think it might be harder for a general webdev to get into using react stuff
#edgeduchess[d]but with nextJS, everything that works for general webdev, mostly works for nextjs too