Skip to content

Conversation

lwasser
Copy link
Member

@lwasser lwasser commented Jul 25, 2024

This is a long one. opening as a draft for now in favor of finishing the sprint one first (which this one needs to link to)


@lwasser lwasser changed the title Blog scipy24 recap feat(blog): scipy24 recap blogpost with pictures Jul 25, 2024
@lwasser lwasser force-pushed the blog-scipy24 branch 3 times, most recently from 9781e08 to 95a2f59 Compare July 31, 2024 22:26
@lwasser lwasser marked this pull request as ready for review July 31, 2024 22:26
@lwasser lwasser requested a review from kierisi as a code owner July 31, 2024 22:26
Copy link
Contributor

@kierisi kierisi left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

reviewed! let me know what questions you have.

@@ -0,0 +1,463 @@
---
layout: single
title: "pyOpenSci a Recap of @ SciPy 2024 Meeting - Tacoma, Washington"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
title: "pyOpenSci a Recap of @ SciPy 2024 Meeting - Tacoma, Washington"
title: "pyOpenSci a Recap of @ SciPy 2024 Meeting - Tacoma, Washington"

I think we can punch this up a bit to be more clear. maybe something like "pyOpenSci at SciPy 2024: a recap of our time in Tacoma"

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

awesome. @kierisi just a note that here you have a suggested change but the actual change is in the comment text so i can't actually "accept" the change and give you credit for it . Would you like to make the change inline so i can commit it (and the commit then is in your name! so your work gets credit). i can also modify locally - up to you!

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nope! I didn't want to assume what the title should be, so feel free to use whatever works best for you :)

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok got it. I suggest that you play with the how comments work and what they look like on GitHub.

This is what i see which suggests you were trying to edit the text inline. When i look at the comment, I think your intention might have been to suggest a change to the header which is why i asked you for followup.

I think your actual intention was just to leave text feedback. it would be more clear to me then if you just left a comment rather than a text suggestion that has no actual changes to the text

Screenshot 2024-08-02 at 10 10 08 AM

does that make sense? please let me know if it doesnt. there are several comments here that look like you started to edit the text and then didn't which will prompt me to ask for more information to ensure i'm capturing the feedbac correctly.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yep, got it! I'll be more decisive next time in whether or not I provide an inline edit, and make sure to use the corresponding feature.

---
layout: single
title: "pyOpenSci a Recap of @ SciPy 2024 Meeting - Tacoma, Washington"
excerpt: "This year I gave a talk and lead a packaging workshop at the SciPy 2024 conference in Tacoma Washington. Learn more about the SciPy meeting and how exciting it was for pyOpenSci to be there this year!"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
excerpt: "This year I gave a talk and lead a packaging workshop at the SciPy 2024 conference in Tacoma Washington. Learn more about the SciPy meeting and how exciting it was for pyOpenSci to be there this year!"
excerpt: "This year our Executive Director and Founder, Leah Wasser, gave a talk and led a packaging workshop at the SciPy 2024 conference in Tacoma, Washington. Learn more about the SciPy meeting and how exciting it was for pyOpenSci to be there this year!"

the preview on our website doesn't show who the author is, so by adding your name in we can ideally get more people interested in reading.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

oh weird. that is a bug! it may be a bug in CI because when i build locally i see the author name and picture on the page. i'm going to hold off on accepting this because I did write the blog post so it should be coming from me . i could mention who i am in the post too however if you think that would be useful.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

are you thinking of the actual blog post page? this is what I see when I go to the main blog page:

Screenshot 2024-08-02 at 5 38 49 AM

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

so there's no author information

(also, I just noted that the alignment is off between the title and the body of the preview text. should I file an issue for that?)

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

that alignment is intentional. I just redid that page this week with the events pr.

the issue that i think you should file is related to wanting the author to be listed on the blog listing page. This topic is out of scope for this pr because this pr is only a new blog post.

Being super specific about where information is missing (in context of a specific PR) is important to avoid scope creep in a single pr and conversations then straying from the pr that we are trying to merge.

Feel free to open an issue (and a pr?) related to the blog landing page and please include screenshots and make it specific if you want someone else to fix it so we can tag it with help wanted!

I spent a lot of time talking with colleagues, friends, and community members
about all things Python, open source, and open science.

* I worked with Sarah Kaiser on our new GitHub container to support workshops.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is there something we could link to for the GitHub container?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

oh yes - it's not merged yet but i could link to the PR! i'll do that locally.

Additionally, I caught up with colleagues, chatting about packaging and scientific Python.


## Sprints
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

going to stop noting it, but overall I think headings could be stronger with a descriptive and declarative statement, which will also help with SEO.

Copy link
Member Author

@lwasser lwasser left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok thank you for the feedback. i've integrated all of the inline comments and left a few questions. i'll work on headers and content enhancements tomorrow so we can get this merged.

---
layout: single
title: "pyOpenSci a Recap of @ SciPy 2024 Meeting - Tacoma, Washington"
excerpt: "This year I gave a talk and lead a packaging workshop at the SciPy 2024 conference in Tacoma Washington. Learn more about the SciPy meeting and how exciting it was for pyOpenSci to be there this year!"
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

oh weird. that is a bug! it may be a bug in CI because when i build locally i see the author name and picture on the page. i'm going to hold off on accepting this because I did write the blog post so it should be coming from me . i could mention who i am in the post too however if you think that would be useful.


</div>

## My SciPy 2024 experience
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

sure - when you say "this" do you mean that first sentence or the paragraph?
If you can help me understand what that would look like then I can make a change locally?


More on all of that below. But first--what is the SciPy Conference?

## About the SciPy Conference
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i like the idea of making it more powerful. Are you suggesting that I change the header text or the content of the paragraph or both?

I'd be remiss if I didn't mention the lightning talk sessions. During lightning
talks, people throw their names into a literal bucket. If their name is selected,
they are given 5 minutes (or less if the dice are rolled) to talk about a topic
they love. At SciPy, there are often off-beat distractions from the moderators
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

oh that is totally what happens. they literally heckle you on the stage and intentionally disrupt. it's funny tho because everyone is used to it. but it really is intentional disruption and the audience just laughs.

Several participants enjoyed the process so much that they joined our sprint
afterwards to help build out the packaging guide. More on that below.

## My talk on Python packaging at SciPy 2024
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ok i think i understand - above you were referencing the headers being changed.

I spent a lot of time talking with colleagues, friends, and community members
about all things Python, open source, and open science.

* I worked with Sarah Kaiser on our new GitHub container to support workshops.
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

oh yes - it's not merged yet but i could link to the PR! i'll do that locally.

@kierisi
Copy link
Contributor

kierisi commented Aug 2, 2024

re: #448 (comment)

I think what's happening there is that I start with a suggested change and then end up deleting it but leaving the comment. I'll be more diligent on that going forward!

as for clarifying, I think if you could "set the scene" and describe what happens at the lightning talks for someone who has never been, it would be great! almost like a tour guide explanation of what happens (it doesn't have to be super in-depth, just enough to give someone context!)

@kierisi
Copy link
Contributor

kierisi commented Aug 2, 2024

re: #448 (comment)

totally about the headers! SEO operates largely on headers, so one of the ways we can continue to grow awareness of pyOpenSci is by writing headers that "answer a question," as it makes them more likely to be picked up by Google, and show up as "snippets" when someone enters a query on the web.

so a totally random and arbitrary example could be someone googling "Is SciPy fun?" and us having a heading like "SciPy is the most fun conference I've ever been to!", which could then get picked up by Google and shown as one of the "featured" snippets in response to the person doing the googling.

you'll actually see people writing for SEO//using AI for SEO try to hijack this, where they'll have a great header, but the actual text under the header doesn't actually answer the question (sometimes it doesn't even address it).

@lwasser
Copy link
Member Author

lwasser commented Aug 2, 2024

ok fantastic @kierisi i went through and tried to make the headers more engaging. I do remember working on this when we optimized earthdatascience.org with seo people. it just takes more time to write. But also i'm not sure if what i've changed hits our goals. can you please re-review this pr with the updated headers? i think once i have a bit more context i can try to just write better headers. That website work i did was in 2016 -- seo has come a long way.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

something weird happened when i rebased... will fix

@@ -112,8 +112,7 @@ fundamental concepts, and
for beginners.

<figure>
<img src="{{ site.baseurl }}/images/blog/2024/may/pyopensci-too-many-python-packaging-options-pycon-talk-2024.png
" alt="A cute image of a black flat coated retriever laying on the floor with a purple ice pack on it's head looking right at you." />
<img src="{{ site.baseurl }}/images/blog/2024/may/pyopensci-too-many-python-packaging-options-pycon-talk-2024.png" alt="A cute image of a black flat coated retriever laying on the floor with a purple ice pack on it's head looking right at you." />
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

somehow this link got broken when i was working on the blog so i fixed it here.

@lwasser
Copy link
Member Author

lwasser commented Aug 2, 2024

@kierisi i suggest that you just go through and add optimizations to the blog post directly as suggested inline changes i have made a lot of changes but also am keen to move past scipy work and focus on fall festival and funding! so if you can help me with the seo part here that would be great. maybe we can try to get this merged by tuesday next week?

Copy link
Contributor

@kierisi kierisi left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@lwasser the headings are great! I made some small grammatical suggestions and left a note on emoji v. font awesome. let me know what questions you have!

Every year at SciPy, we spend the last two days of the meeting sprinting.
This year was the first time I stayed for both days of the sprints.

### A brief overview of open-source sprints
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### A brief overview of open-source sprints
### A brief overview of open-source software sprints

@lwasser
Copy link
Member Author

lwasser commented Aug 6, 2024

ok i am going to merge this once CI finishes!

@lwasser lwasser merged commit b3813f4 into pyOpenSci:main Aug 6, 2024
4 checks passed
@lwasser lwasser deleted the blog-scipy24 branch August 6, 2024 19:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants