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

NumPy.org site map - tracking issue #43

Open
rgommers opened this issue Sep 9, 2019 · 30 comments
Open

NumPy.org site map - tracking issue #43

rgommers opened this issue Sep 9, 2019 · 30 comments
Assignees

Comments

@rgommers
Copy link
Member

rgommers commented Sep 9, 2019

No description provided.

@InessaPawson
Copy link
Member

The latest version of the site map is stored here: https://app.flowmapp.com/share/e1b61759a5f95f43d8907baedf42875d/sitemap/

@Shekharrajak
Copy link
Member

The latest version of the site map is stored here: https://app.flowmapp.com/share/e1b61759a5f95f43d8907baedf42875d/sitemap/

This is looking nice. It would be great if you can write few points about the page and may be the existing working URL of the corresponding page in the labels. e.g. I didn't get the Array Computing page - means what will be the content there (I can't find the corresponding page in current site)

@InessaPawson
Copy link
Member

Thank you for your feedback, @Shekharrajak! Yes, I'm currently working on including more info + content for each page. As far as linking to the existing working URLs most of the proposed is brand new to numpy.org.
“Array Computing” page is proposed in NEP 28 (numpy.org/neps/nep-0028-website-redesign.html). @rgommers would be the best person to answer any questions about it. I haven’t got to it just yet.:)

@InessaPawson InessaPawson self-assigned this Sep 20, 2019
@rgommers
Copy link
Member Author

rgommers commented Sep 21, 2019

That site map looks cool!

There some content I drafted for About Us, Community, Install and Learning at https://github.com/rgommers/numpy.org/tree/newsite-content/www

“Array Computing” page is proposed in NEP 28 (numpy.org/neps/nep-0028-website-redesign.html). @rgommers would be the best person to answer any questions about it.

This would have some general content about what array computing (i.e. computing with n-dimensional arrays, the core of what NumPy is about) and how NumPy fits into the whole ecosystem here and what related projects are. Have a look at "Integrates with existing projects" and "Powered by Dask" on https://dask.org/ to get an idea of the type of content I'm thinking about.

See also gh-44

@rgommers
Copy link
Member Author

A few thoughts on the site map:

  • Looks quite complete, I'm not missing anything important.
  • Community Survey: running the survey is a time-limited thing, but publishing the results on this page sounds like a really nice idea
  • Case Studies: would put that on the front page, or linked from front page via an image/summary
  • Annual Reports: the BIDS grant reports can be a good start for that. Also links to the NumFOCUS annual reports. I'd rename it though, to avoid giving the impression or making the commitment that we will write an annual report (can't really do that right now)
  • Tools and Libraries and Extensions could be merged, not sure what would go where otherwise.

@datapythonista
Copy link

We discussed with @rgommers that it'd be good for users to have the navigation somehow standardized among projects (mainly for users common to different projects).

You structure looks quite good to me, I like some of the ideas and I think we can adopt them.

But my feeling is that 8 items in the top navigation are too many. In pandas currently we have 4, and I don't think we should have many more. You can see them here: https://dev.pandas.io/ I see Dask having 6, and as a user I feel it starts making things a bit too complex. Do you have a prototype to see that structure implemented already?

@rgommers
Copy link
Member Author

Do you have a prototype to see that structure implemented already?

Not yet; the outlines are starting to become visible in the newsite branch in this repo.

@rgommers
Copy link
Member Author

But my feeling is that 8 items in the top navigation are too many. In pandas currently we have 4, and I don't think we should have many more. You can see them here: https://dev.pandas.io/ I see Dask having 6, and as a user I feel it starts making things a bit too complex.

Not so sure, I quite like the Dask site. It's still on the minimal side I think. https://jupyter.org/ and https://julialang.org/ have 8 in the menu bar, https://quantecon.org/ has 6, python.org has two menu bars with 6 entries in the top one and 7 in the bottom one.

So I think 6 is the absolute minimum we can get away with; anything in the 6-8 range is fine.

https://dev.pandas.io/ has 4 in the top bar, but then another set of navigation links under the install button, and more in the side bar. It looks quite a bit busier than the Dask site.

@datapythonista
Copy link

I think in pandas we like things a bit more minimalist, you can see it in the API. ;)

To focus a bit more the conversation, since the size of the nav bar seem to be a question of preference, I see that those should be non-controversial:

  • Install
  • Documentation
  • Community
  • Donate

Some of the differences are:

  • About us at the top level: We don't have that much there yet, but I guess it can make sense for us. Just the blog, I think it belongs to the community in our case, since it'll be an aggregator of other blogs.
  • Contribute: Do you have it at the top level to make it more visible, or do you think doesn't belong to Community (where we have it)?
  • Learning: If I get it right, besides the tutorials, you'd have there a page with links to stackoverflow and discourse, and another for what we call ecosystem. I'd personally look for those two in community. Is any other project using this structure? I see Julia has a learning section, but I think only for tutorials
  • I think if we wanted an equivalent of "Array computing" will be in the same ecosystem page. But I guess it's more important for you, and I think it's fine that we differ on that.

@rgommers
Copy link
Member Author

rgommers commented Sep 21, 2019

Contribute: Do you have it at the top level to make it more visible, or do you think doesn't belong to Community (where we have it)?

Yes, I think this could be folded into Community, that would make sense. Visibility was a thought, but I didn't think all that hard about it.

Learning: If I get it right, besides the tutorials, you'd have there a page with links to stackoverflow and discourse, and another for what we call ecosystem. I'd personally look for those two in community. Is any other project using this structure? I see Julia has a learning section, but I think only for tutorials

I indeed like the way Julia does it. Tutorials, videos, books, courses, cheat sheets. There's enough scope there that I wouldn't just put it under Documentation.

Tools + Libraries/extensions --> Ecosystem does make sense to me. It's not clear that it needs to be under Learning, could also be under Community or, maybe best, on the main page like on https://julialang.org/.

About us at the top level: We don't have that much there yet, but I guess it can make sense for us. Just the blog, I think it belongs to the community in our case, since it'll be an aggregator of other blogs.

Jupyter has Donate under About Us. I like the way Jupyter does it. And now that I checked, that's how I wrote the content already: https://github.com/rgommers/numpy.org/blob/newsite-content/www/about.md

@InessaPawson
Copy link
Member

InessaPawson commented Sep 21, 2019

A few thoughts on the site map:

  • Looks quite complete, I'm not missing anything important.
  • Community Survey: running the survey is a time-limited thing, but publishing the results on this page sounds like a really nice idea

Yes, that is exactly what I had in mind for the Community Survey page.

  • Case Studies: would put that on the front page, or linked from front page via an image/summary

Makes a lot of sense!

  • Annual Reports: the BIDS grant reports can be a good start for that. Also links to the NumFOCUS annual reports. I'd rename it though, to avoid giving the impression or making the commitment that we will write an annual report (can't really do that right now)

Instead of a separate page, let’s have sections on the Donate page linking to NumFocus and BIDS annual reports. @rgommers, what do you think?

  • Tools and Libraries and Extensions could be merged, not sure what would go where otherwise.

Done!

@datapythonista
Copy link

datapythonista commented Sep 21, 2019

Thanks @rgommers, good feedback.

I think something like this makes sense to me (and to you for what you say):

  • Install
  • Learning (probably a single page)
    • Tutorials
    • Videos
    • Books
    • Courses
    • Cheat sheets
  • Documentation
    • User guide
    • API reference
    • Release notes
    • Older versions
    • ... (NEPs, f2py guide for NumPy...)
  • Community
    • Blog
    • Ask a question (StackOverflow)
    • Discuss (Discourse)
    • Contributing
    • Code of conduct
    • Community survey
  • About us
    • Our history
    • Ecosystem
    • Roadmap
    • Team
    • Sponsors
    • Citing pandas
    • Donate
  • ... (Array computing for NumPy - NBViewer, JupyterHub, Widgets for Jupyter,...)

You'd have the Array computing in the top level too. And there are minor things like whether donate is in the top level or in about us (I think some extra money from having in the top level would be nice). Or the roadmap (you've got it in community, but I guess may make more sense in About us).

Is there anything that you would change?

@rgommers
Copy link
Member Author

Annual Reports: the BIDS grant reports can be a good start for that. Also links to the NumFOCUS annual reports. I'd rename it though, to avoid giving the impression or making the commitment that we will write an annual report (can't really do that right now)

Instead of a separate page, let’s have sections on the Donate page linking to NumFocus and BIDS annual reports. @rgommers, what do you think?

Makes sense, let's do that.

You'd have the Array computing in the top level too. And there are minor things like whether donate is in the top level or in about us (I think some extra money from having in the top level would be nice). Or the roadmap (you've got it in community, but I guess may make more sense in About us).

Is there anything that you would change?

That looks pretty good. Only minor tweaks perhaps:

  • Documentation will have some more things for us, like NEPs, f2py guide, and links to older versions of the docs
  • Ecosystem: on front page rather than About Us
  • Roadmap: not sure, perhaps linked from front page. About Us doesn't seem like the most obvious place.

@datapythonista
Copy link

Makes sense, we'll also have to link to older versions of the documentation. I added links to the home page, but I think having it under documentation also makes sense. I updated the tree with the sections specific to NumPy.

For the ecosystem and the roadmap, when you say having them in the front page, you mean in the home, like in the navigation we've got in the middle of dev.pandas.io? Not sure if About us is the best place, but I guess they should be in the navigation bar too. Don't you think so?

@rgommers
Copy link
Member Author

For the ecosystem and the roadmap, when you say having them in the front page, you mean in the home, like in the navigation we've got in the middle of dev.pandas.io? Not sure if About us is the best place, but I guess they should be in the navigation bar too. Don't you think so?

No not navigating to it from anywhere, the actual content present on numpy.org. See how Ecosystem is done on https://julialang.org/.

I think it's a bit of a waste that there are only links on dev.pandas.io itself, why not put something interesting there?

@datapythonista
Copy link

Ah, I see, thanks for clarifying. Our new home is far from finished, we're still discussing what to have there (pandas-dev/pandas#28168).

I added having the ecosystem too, I think it's a good idea. But our ecosystem is huge, we can have the basics in the home, but we'll need to have a separate page too. And I think would be nice to have it in the navigation.

For the roadmap, I see it complements well "Our history" in About us. Seems like Our history is the past of the project, and the roadmap is the future of the project itself, not so much a community thing (in that sense). We have a link from donate, and having a link in the home sounds good to. But as with the ecosystem, I think it should also be in the navigation.

@datapythonista
Copy link

Did a quick test with our website, and I think the size of the navbar and the dropdowns is great with the current proposal: https://datapythonista.github.io/pandas-web/ (most of the links will be broken, but gives an idea of the navigation).

@InessaPawson
Copy link
Member

  • Contribute: Do you have it at the top level to make it more visible, or do you think doesn't belong to Community (where we have it)?

I love, preach, and practice intuitive, clean and minimalistic UX. While designing the top navigation bar, I’ve carefully considered the needs of all NumPy stakeholders, including the project itself. Our current most pressing needs are contributors and funding. By placing the “Contribute” button in the top navigation bar we will plant an idea in the head of those who haven’t considered contributing before, and we will make it easy to sign up for those who are ready. Just like by placing the “Donate” button will indicate to the new community members that we are a non-profit with all the opportunities and constraints that come with this kind of business model. Hopefully we will get some donations as well.

  • Learning: If I get it right, besides the tutorials, you'd have there a page with links to stackoverflow and discourse, and another for what we call ecosystem. I'd personally look for those two in community. Is any other project using this structure? I see Julia has a learning section, but I think only for tutorials

Students and educators are a large and probably the fastest growing part of the NumPy community. Placing educational materials under “Community” is not intuitive enough for this group, especially if English is their second language, and they are new to Data Science and/or open source.

  • Just the blog, I think it belongs to the community in our case, since it'll be an aggregator of other blogs.

I was considering to place “Blog/Newsletter” as a child page of “Community”. (@rgommers I’m leaning towards naming the button as “Newsletter”. ) Here is why I’ve decided that it belongs to the “About Us” section: we are planning to spotlight our contributors in the newsletter, which would be complementing “Our team” page in the same menu.

  • For the roadmap, I see it complements well "Our history" in About us.

Agreed! There is an existential balance in having “History” and “Roadmap” in the same navigation bar. :)

  • I think if we wanted an equivalent of "Array computing" will be in the same ecosystem page. But I guess it's more important for you, and I think it's fine that we differ on that.

We might make “Array Computing” a child page or section of another web page. We need to finish writing up our content to make the final decision.

@InessaPawson
Copy link
Member

InessaPawson commented Sep 22, 2019

Roadmap: not sure, perhaps linked from front page. About Us doesn't seem like the most obvious place.

@rgommers I think we should do both.

@InessaPawson
Copy link
Member

Tools + Libraries/extensions --> Ecosystem does make sense to me. It's not clear that it needs to be under Learning, could also be under Community or, maybe best, on the main page like on https://julialang.org/.

My vote goes to the third option - placing it on the main page. It should be a part of the intro to NumPy.

@InessaPawson
Copy link
Member

Install
Learning
Documentation

@rgommers @datapythonista Is this order a go? Frankly, I quite liked having "Learning" and "Community" next to each other.

@rgommers
Copy link
Member Author

I love, preach, and practice intuitive, clean and minimalistic UX. While designing the top navigation bar, I’ve carefully considered the needs of all NumPy stakeholders, including the project itself. Our current most pressing needs are contributors and funding. By placing the “Contribute” button in the top navigation bar we will plant an idea in the head of those who haven’t considered contributing before, and we will make it easy to sign up for those who are ready.

This is a very good point. We do really need to gain more contributors to various areas of the project. Okay, you've convinced me:)

Agreed on the Roadmap in both places and importance of top-level Learning too.

Just like by placing the “Donate” button will indicate to the new community members that we are a non-profit with all the opportunities and constraints that come with this kind of business model. Hopefully we will get some donations as well.

Donations are unlikely to be a major part of the kind of revenue stream we need, and I don't think it gives the right signal to larger potential funders. So if it's top-level, it should be called Support or Funding or some such phrase.

@rgommers @datapythonista Is this order a go? Frankly, I quite liked having "Learning" and "Community" next to each other.

I didn't think much about order. Learning and Community next to each other sounds good to me.

@datapythonista
Copy link

Good feedback, thank you. I made the donation pages a starting point for anyone supporting the project, linking to contribue to. I think pandas has enough contributors (like first timers), and individual donations are also not very significant. I think what makes sense to me is to have contributing in the top level, and make the home page of contributors similar to what is the donations page now (do you want to contribute time? money? ...)

Didn't think about the order much either. But I've been sharing the draft in dev.pandas.io and experimenting with it myself, and it doesn't feel very natural, I think what makes sense in our case is:

  • About us
    • Our history
    • Ecosystem
    • Roadmap
    • Team
    • Sponsors
    • Citing pandas
    • Donate
  • Getting started (what was Install + Learning before)
    • Install
    • Tutorials
    • Videos
    • Books
    • Courses
    • Cheat sheets
  • Documentation
    • User guide
    • API reference
    • Release notes
    • Older versions
    • ... (NEPs, f2py guide for NumPy...)
  • Community
    • Blog
    • Ask a question (StackOverflow)
    • Discuss (Discourse)
    • Code of conduct
    • Community survey
  • Contributing
  • ... (Array computing for NumPy - NBViewer, JupyterHub, Widgets for Jupyter,...)

For what you say, and given that NumPy is much more academic than pandas, I guess you prefer the separate learning section in the top level. But to me it doesn't feel natural, since our install is quite minimal, and the feedback about the learning section wasn't positive.

You can give it a try at dev.pandas.io. I'll probably implement the new structure this evening (Europe).

@InessaPawson
Copy link
Member

Donations are unlikely to be a major part of the kind of revenue stream we need, and I don't think it gives the right signal to larger potential funders. So if it's top-level, it should be called Support or Funding or some such phrase.

Let's fold it under "Contribute" then.

shaloo added a commit to shaloo/numpy.org that referenced this issue Nov 4, 2019
shaloo added a commit to shaloo/numpy.org that referenced this issue Nov 5, 2019
shaloo added a commit to shaloo/numpy.org that referenced this issue Nov 11, 2019
rgommers pushed a commit to shaloo/numpy.org that referenced this issue Nov 13, 2019
rgommers pushed a commit to shaloo/numpy.org that referenced this issue Nov 13, 2019
rgommers pushed a commit to shaloo/numpy.org that referenced this issue Nov 13, 2019
rgommers pushed a commit to shaloo/numpy.org that referenced this issue Nov 13, 2019
shaloo added a commit to shaloo/numpy.org that referenced this issue Nov 15, 2019
shaloo added a commit to shaloo/numpy.org that referenced this issue Nov 15, 2019
shaloo added a commit to shaloo/numpy.org that referenced this issue Nov 15, 2019
rgommers pushed a commit that referenced this issue Nov 15, 2019
Reference: gh-43, which outlines the new website page structure
shaloo added a commit to shaloo/numpy.org that referenced this issue Nov 19, 2019
shaloo added a commit to shaloo/numpy.org that referenced this issue Nov 19, 2019
shaloo added a commit to shaloo/numpy.org that referenced this issue Nov 19, 2019
shaloo added a commit to shaloo/numpy.org that referenced this issue Nov 19, 2019
shaloo added a commit to shaloo/numpy.org that referenced this issue Nov 19, 2019
shaloo added a commit to shaloo/numpy.org that referenced this issue Nov 19, 2019
shaloo added a commit to shaloo/numpy.org that referenced this issue Nov 19, 2019
shaloo added a commit to shaloo/numpy.org that referenced this issue Nov 19, 2019
@InessaPawson InessaPawson changed the title NumPy.org site map NumPy.org site map - tracking issue Jan 18, 2020
@InessaPawson
Copy link
Member

We will be updating the sitemap as more pages are added. @rgommers , should we keep this issue open?

@rgommers
Copy link
Member Author

Let's leave it open for now; makes it easy to find the sitemap, and I think we should revisit this after launching the new site, there's some useful discussion about site structure

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

5 participants