Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Appropriate length of "recent news" ? #8

Open
dhdeangelis opened this issue Apr 18, 2022 · 8 comments
Open

Appropriate length of "recent news" ? #8

dhdeangelis opened this issue Apr 18, 2022 · 8 comments

Comments

@dhdeangelis
Copy link
Contributor

dhdeangelis commented Apr 18, 2022

Thinking from the point of view of someone seeing the PDL website for the first time or a new prospective user. The two central paragraphs are broad and short, whereas the news feed is thin and long. This creates visual and usability imbalance. Perhaps the page will be more pleasant to read and browse for a new visitor if the feed is limited to the last N important changes, while pointing in the last entry to a more complete history somewhere else? How long back in time should the "recent news" feed reasonably go? The current one goes back to 2014. Is all this still relevant today?

@mohawk2
Copy link
Member

mohawk2 commented Apr 23, 2022

You raise an excellent point! I had noticed this myself. My thinking so far is we should make the news bit a bit less redundant by removing items that aren't important now. One strategy would be maximum two items about the same library, including PDL, and make sure that recent releases are actually mentioned (eg PDL::LinearAlgebra).

I also think there's room to put more stuff in the middle, even if that would be somewhat "below the fold". I'm very open to ideas on what; something to help people onboard with PDL? A bit more "showing off" stuff?

@mohawk2 mohawk2 changed the title aproppriate length of "recent news" ? Appropriate length of "recent news" ? Apr 23, 2022
@dhdeangelis
Copy link
Contributor Author

You raise an excellent point! I had noticed this myself. My thinking so far is we should make the news bit a bit less redundant by removing items that aren't important now. One strategy would be maximum two items about the same library, including PDL, and make sure that recent releases are actually mentioned (eg PDL::LinearAlgebra).

Fine. Then I can make a proposal following those lines and send a PR

I also think there's room to put more stuff in the middle, even if that would be somewhat "below the fold". I'm very open to ideas on what; something to help people onboard with PDL? A bit more "showing off" stuff?

Definitely. There are already images. May be links to sites can be included, with examples and code, etc.

@mohawk2
Copy link
Member

mohawk2 commented Apr 24, 2022

Thank you for the news-update! I've added a bit of info to the PDL::LinearAlgebra one to show the important changes. It reminds me that not all releases would need to go in the sidebar; 0.28 and 0.29 were effectively bugfix releases and don't really need to be "news". Managing this sort of thing isn't entirely something that can be automated.

@dhdeangelis
Copy link
Contributor Author

dhdeangelis commented Apr 24, 2022

Thank you for the news-update! I've added a bit of info to the PDL::LinearAlgebra one to show the important changes. It reminds me that not all releases would need to go in the sidebar; 0.28 and 0.29 were effectively bugfix releases and don't really need to be "news". Managing this sort of thing isn't entirely something that can be automated.

In the course of shortening the news feed I realized that some package updates had more recent versions, so I just bumped them up. I do not see an easy way of automatizing this right now, but there is probably one. In the meanwhile I can see to add or edit entries manually as needed.

@mohawk2
Copy link
Member

mohawk2 commented Apr 24, 2022

In the course of shortening the news feed I realized that some package updates had more recent versions, so I just bumped them up. I do not see an easy way of automatizing this right now, but there is probably one. In the meanwhile I can see to add or edit entries manually as needed.

I think the best solution for now is to keep a human editor in the loop :-)

@dhdeangelis
Copy link
Contributor Author

Regarding comment in PR #18 I also believe that it would be nice if the announcements can be spared somehow. I will see if I can come up with some ideas for that.
As for update history I am not worried, we could link to: https://metacpan.org/dist/PDL/changes for the whole PDL history at the end of the "recent news" side box.

@mohawk2
Copy link
Member

mohawk2 commented May 7, 2022

I think the solution will be for us to implement #9, but regardless, each change you're making brings real improvement!

@dhdeangelis
Copy link
Contributor Author

I think the solution will be for us to implement #9, but regardless, each change you're making brings real improvement!

I already looked at #9 and thinking on how it can be implemented.

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

No branches or pull requests

2 participants