Posts by sarah11918@mastodon.social
(DIR) Post #AWRQ7nKSDQYVS42vya by sarah11918@mastodon.social
2023-06-06T21:50:56Z
0 likes, 0 repeats
@astro @swithinbank The entire @astrodotbuild team rallied around this wild idea for a...docs theme?From @erika and @bholmesdev ensuring assets and content lived in harmony, @bluwy & @tonysull digging deep for feature/perf perfection and Fred's project championing: a team effort.We didn't just launch a docs theme. We lauched a TRANSLATED docs theme with built-in languages! Our community translators made sure our i18n story was solid, and you can choose your language(s) and GO!/2
(DIR) Post #AWRQ7pLaiAeZiAas1g by sarah11918@mastodon.social
2023-06-06T21:52:39Z
0 likes, 0 repeats
@astro @swithinbank @erika @bholmesdev @bluwy @tonysull We also had some amazing community contributions and input. Fun fact: The name Starlight was originally proposed by @kevinzunigacuel! 🌟And, no one could ever say enough about @yanthomasdev and his contribution to any project he works on. Nothing gets merged until Yan has approved the a11y and i18n infrastructure... and removed all my superflous commas./3
(DIR) Post #AWRQ7rIpRPdFmBJgzw by sarah11918@mastodon.social
2023-06-06T21:53:48Z
0 likes, 0 repeats
@astro @swithinbank @erika @bholmesdev @bluwy @tonysull @yanthomasdev Starlight truly *shines* because of @doodlemarks exceptional design and project management... and hiswillingness to dive into this build-in-public idea of ours. Mark led the project with grace, and jorts, all while having a pretty big *light* shone upon him!/4
(DIR) Post #AWRQ7tG4AebvqC2VyC by sarah11918@mastodon.social
2023-06-06T21:56:09Z
0 likes, 0 repeats
@astro @swithinbank @erika @bholmesdev @bluwy @tonysull @yanthomasdev @doodlemarks And... how am I supposed to describe @swithinbank s role in all this? Relentless commitment to his principles of empathy, inclusivity, and sustainability. Code you can read, customize, and maintain. Care and thought in the truest, purest sense of the words.Starlight is for everyone, and was made by everyone. This is a startrail I'm happy to have been on for the ride!Today, you all shine./5
(DIR) Post #AWeCbBVUrcf3V7y4bA by sarah11918@mastodon.social
2023-06-13T11:04:54Z
0 likes, 1 repeats
Check out the latest GitHub README Project "Why non-code contributions are the secret to open source success!" 🏆 (Also, learn my @astro origin story?? 👀)📰 Article:https://github.com/readme/featured/open-source-non-code-contributions🎙️ Podcast episode: https://github.com/readme/podcast/code-and-community
(DIR) Post #AXmIJc3Bb5Zpk1TKbI by sarah11918@mastodon.social
2023-07-16T16:40:37Z
0 likes, 1 repeats
So if you're wondering, "How is *Sarah*, of all people, one of the most prolific @astro Discord support repliers?" 😅 Never underestimate the extent to which you can *be helpful*, even if you aren't the most super-l33t technical person.I tutored math for almost 20yrs. People are just naturally *nervous* and *tentative* while learning, and just a friendly, confident "You got this!" (or, often, "You can't screw this up!") does wonders.So, jump in your fave OSS support forum and help! 🙌
(DIR) Post #AXmIJe2CDjyPtX1ZKq by sarah11918@mastodon.social
2023-07-16T18:14:47Z
0 likes, 0 repeats
General positivity aside: I do also want to say, though, that I'm pretty happy with my actual advice: there *are* more reasons than reusability to embrace component-based design. And, refactoring-as-pain-mitigation is a great strategy, too.Working on the docs helps me confidently give good Astro advice. But, also "living in this house" ( 😅 ) and applying that unavoidable influence to Astro code design patterns in general are all part and parcel of the support you get when you build #WithAstro.
(DIR) Post #AZ7y01LK85nR25xfvM by sarah11918@mastodon.social
2023-08-26T12:20:34Z
0 likes, 1 repeats
Next week is @astro v3.0 Launch Week! 🥳 For v2.0, our community translators prepared the docs landing page banner linking to our upgrade guide in 6 languages on launch.Astro 3.0 will launch with the entire upgrade guide itself AND our star feature (View Transitions) docs in at least 4 languages!(And don't even get me started about how many languages Starlight *ships* with: native, *human* UI translations out-of-the-box.)When community building, don't forget your translators! 💜 🌐 🚀
(DIR) Post #AZYMvSrilzrrVhFWQS by sarah11918@mastodon.social
2023-09-07T21:45:21Z
0 likes, 1 repeats
I'm so thrilled to be sharing the (virtual) stage with the rest of the amazing speakers at @viteconf next month! 🥳 I've got my @astro@webtoo.ls-branded ticket, do you have yours? https://viteconf.org/23/speaker/sarah11918
(DIR) Post #AZriGv5IyTwL2OpoDg by sarah11918@mastodon.social
2023-09-16T22:11:34Z
0 likes, 1 repeats
I keep refreshing the @viteconf website hoping to see talk titles added to the recently-revealed speakers list. Can't wait to see what everyone will be sharing!Me? I'll be challenging the very notion that "writing good docs" has to be about writing at all!So, not a "writer" yourself? No problem! You can still craft good docs for your software project or feature!Get your free ticket: https://viteconf.org/23/speaker/sarah11918#ViteConf #ViteConf23
(DIR) Post #AZriGxCT6orHbCCYfA by sarah11918@mastodon.social
2023-09-17T00:10:20Z
0 likes, 0 repeats
It's almost a shame my talk is already recorded and submitted, bc today I needed instructions that were in fact well-written BUT...were:- in a pdf (so, no text to show up in site search results)- not on the page I expected (but OTHER guides WERE there. So, thought must be right place & if not there, must not exist)- an inconspicuous text link vs similar guides with full-graphic cards for their linksWhen I say, "Yes, you can make your docs way better without doing ANY writing!" . . . 😅
(DIR) Post #AaAUdzRtU9iNzBZKOe by sarah11918@mastodon.social
2023-09-26T17:19:05Z
0 likes, 2 repeats
I know there were valid tech reasons for @astro to move to @vite, but I'm personally most happy about the excuse to join forces with such a(nother) wonderful community!I hope you've got your (free!) ticket for ViteConf (online!), because it is shaping up to be the web dev event of the year! So many frameworks represented in the session talks, streamed for 24 hours straight for our global community!(You might see a little more of me than you bargained for, but don't hold it against them.)
(DIR) Post #AaTG1ZMqrU2EnM5ldw by sarah11918@mastodon.social
2023-10-05T20:09:37Z
0 likes, 1 repeats
Are you watching @viteconf ? 30 minutes until the Community & Open Source section of talks and the panel! (Bonus, immediately followed by @astro View Transitions)My talk "Stop Writing; Start Helping" for... reluctant docs writers? ... leads off the block of sessions.You can watch it, or find out more at https://viteconf.org/23/live (also replayed again 12 hours later)
(DIR) Post #AaW2gtMibCgCo2ifFw by sarah11918@mastodon.social
2023-10-06T17:17:13Z
0 likes, 1 repeats
OK, the @ViteConf posts can stop (after this one): You can catch the reply of the entire 12 hrs: scroll down a bit for the schedule and click on any talk to go straight to it.Or go straight "Stop writing docs; Start helping!" 😉 https://viteconf.org/23/replay/docs Thank you to @patak and the amazing speakers, organizers, sponsors and moderators for such a wonderful event.Thanks to everyone who watched, esp my fellow 12-hrs'ers, and I hope you all find something new and exciting in the replay!
(DIR) Post #AayWpuuRRXKV4cycqG by sarah11918@mastodon.social
2023-10-20T21:21:39Z
0 likes, 0 repeats
I just realized that @grammargirl might know the answer to a question that has plagued me for years!"agree vs concur" -- I "heard"somewhere long ago that to concur is to arrive at or accept the same conclusion/agree with a conclusion either despite not being fully onboard with the reason/logic or arguments that led to it, or getting there for diff reasons entirely.So, it lets you "disagree" on some principle while also, ultimately "agreeing", I guess?Is there any basis or truth to this?
(DIR) Post #Ab0QnVVwgCdAK9uGpM by sarah11918@mastodon.social
2023-10-21T18:10:17Z
0 likes, 2 repeats
You didn't think the @viteconf posts were actually going to stop, did you?? 😂 The full playlist of talks is up!If you want to see me talk about making your docs better even *without* doing any writing, you can hop into the playlist at this point: https://www.youtube.com/watch?v=jcpkVJr-rUw&list=PLqGQbXn_GDmkOsHI7-Wrbv1GgAA4tJZhg&index=26For an amazing panel talking about building and engaging community, including through docs, jump into the playlist here: https://www.youtube.com/watch?v=rqB7hy5lcmc&list=PLqGQbXn_GDmkOsHI7-Wrbv1GgAA4tJZhg&index=29Need that intro? https://www.youtube.com/watch?v=veCxKeLl35A&list=PLqGQbXn_GDmkOsHI7-Wrbv1GgAA4tJZhg&index=1Go find out all @vite has to offer!
(DIR) Post #Abjq6uq20D9NoKpFwG by sarah11918@mastodon.social
2023-11-12T17:39:54Z
0 likes, 2 repeats
@astro won the GitHub universe Audience Choice Award last week, for> a project that has helped them create an impactIt sure *feels* like WE create an impact, by all the comments I read from ppl who feel our docs, dx, tooling, tutorial, community and entire thoughtfully-crafted and developed project enables and empowers both newer devs and those just "too old for this shit" alike.But, that people feel like THEY are creating THEIR own impact WITH Astro?That's joy on a whole n'other level.
(DIR) Post #Abl0stmwP04d9drJgW by sarah11918@mastodon.social
2023-11-12T18:25:14Z
0 likes, 0 repeats
I also figured out how to map a custom copy (tap) and paste (long press) button on my Glove80, and now I need an entirely new kind of Astro sticker sheet I think! #Glove80 #MoErgo
(DIR) Post #AcdZBDT5ISmWPe9dHk by sarah11918@mastodon.social
2023-12-09T12:22:17Z
0 likes, 1 repeats
Something the "just let AI draft your docs" crowd doesn't seem to get:It's harder to turn "bad docs" into "good docs" than it is to write good docs from scratch.Even putting aside LLMs are trained to (re)produce the "average" (and, how great are "average" docs out there?), your "bad docs" anchor you. You are primed to "fix" the odd word in place, but you now have to *actively work* to "envision" better.You didn't trust yourself (were too lazy) to write. You thought editing would be easier?
(DIR) Post #AmHaNZugdcoIQrIo0u by sarah11918@mastodon.social
2024-09-22T19:03:53Z
0 likes, 1 repeats
#SilentSunday