[Author Prev][Author Next][Thread Prev][Thread Next][Author Index][Thread Index]

Re: [pygame] Re: sprint this weekend



So, what you want for website design is something familiar which follows normal conventions. "Intuitive" really boils down to "like the stuff I've seen before". There's a lot of design decisions to the site that you just don't see anywhere else, and this causes confusion.

(Keep in mind, I do intend these comments to be constructive.)

- The categories have unconventional names. You'd expect About/Download/Documentation/Contribute/Community/News (much like python.org), rather than show/learn/make/create/collaborate/awesome. The "show" column is under Create when you'd think it'd be under Show. Make and Create and Collaborate seem to all have things that would go under a "Contribute" or "Development" section.

- There is no clear "Download" link for downloading Pygame. You have to go to the "create" section, find the "downloads" column (this shouldn't take up an entire column) and click on "download.shtml" (a link that does not have a clear name). Confusingly, this goes back to a page in the old site style.

- There is no clear "Documentation" link. The "learn" section doesn't have a clear link to the API Reference. The "tutorials", "Cookbook", and "Resources" columns (aside from not having consistent casing) have overlapping contents. Sometimes they have links, other times they have text content (in a hard-to-read column). It's hard to find help.

- The section headings' background color has no margins and inconsistent capitalization (most are all lowercase, but About is capitalized).

- The column format is hard to read. Sliding the columns is confusing (no other conventional website does this) and unless I have my browser maximized it's easy to miss column. The transitions are slow and kind of nauseous to look at.

- The media player and keyboard arrow keys take up important real estate at the top of the page, but these aren't important enough to have such a prime spot.

- The navigation names for the top bar are unconventional and confusing. I don't know what "show" really means, "learn" is normally called "Documentation", "make" is normally called "Contribute", and the create/collaborate/awesome seem to be three forms of miscellaneous.

- The search results page is hard to read, there's no separation between the results, and it seems to cut off early.

- In general there's way too much descriptive text up front. The front page should mostly just be links to other pages with more detailed information.

The navigation is the most serious problem, and why I think the entire design doesn't work. The columns may work on mobile, but on the desktop it looks squished and the sliding transition is slow and disorientating. Something more conventional would work a lot better. See python.org (which recently underwent a redesign) for an idea of what pygame.org should be more like.

Again, I know this sounds harsh and I do point these out to be constructive. But a lot of these problems are so obvious and large that I don't think small adjustments can fix them. It reminds me of the car that Homer Simpson designed in that one episode of The Simpsons, where he had several cool ideas for what a car should be, but when put together it was completely unworkable. The old site design works much better, and I think any professional web designer would agree.

-Al

On Tue, Aug 18, 2015 at 11:37 PM, Renà Dudfield <renesd@xxxxxxxxx> wrote:
Hi Ian,

yes dog fooding is a pretty useful motivator!

I'll address each of your good feedback points (plus a few thrown in from other people).

Many people are comfortable with 90s website design(including me), and there's work in progress to create this too as the lofi version. Very much like the existing website (which still functions now).

Finding documentation. Yes, this needs to be improved. If you search for "documentation" it's the first result. If you go the the "learn" section the Documentation link is there, however a lot of other things are taking up space. I think I'll bold the documentation link there. (or someone else feel free to change it in the wiki). If you type pygame docs in your location bar of your browser you get there. Knowing how many people go directly to the documentation of pygame rather than through the website, I know for sure this is how people get there. A "getting started" section is something I've been thinking about quite a bit, and have designs and drawings for. This contains most of your getting started stuff. Like documentation and installation. When thinking on how to do the new downloads page 'Downloading' things is not how people should be getting started with pygame... mostly. pip install, apt-get install.

Adding a project is still done through the old mechanism, but I will make that more clear. Probably by making an "Add your project" link at the top that just goes to the old new project page until the various new forms are done. Sharing via pypi and listing from pypi is also very important. We don't want to be a completely different python projects island.

Contributions to the website, can be increased by one of my sprint goals to open up much of the code (baring a few secret bits like passwords and unfinished parts). Basically I'll try and publish all website code on the pygame bitbucket but also on pypi and for the _javascript_ stuff on jquery plugins website and bower(like pip for front end _javascript_ stuff). There's already a couple of bits public. If you know how to do jquery plugins, then you can contribute new features quite easily. However, this site can be contributed to in many other ways not possible on other websites. There's over 500 items of content on there done by other people, with hundreds of contributors. Not only that, but there are a number of open website issues in which people can already contribute to the website. I hope the API of public pygame.org data will also allow people to do their own projects with pygame website data more easily.

For exploring projects in a creative interesting way, does anyone have any ideas? One idea was a big tag cloud that morphs around, somehow being used to view different parts of the pygame project galaxy. I'm going to put a column section up like http://pygame.org/tags/ where you can browse through them, and also a page which has tags just like that page, followed by lists.
Project pages are another area where I really want to concentrate on, because that will provide a lot more value for people making things. Stuff like github, and bitbucket integration, and linking to their blogs and youtube feeds etc. I hope this can help with collaboration more. But also when we can things from the projects like videos, blog posts, commits, etc and aggregate them for people -- that feeds interesting content into the main pygame website.

Finding libraries, should really go more in a direction of pypi. Part of this is getting pygame itself installable via pypi (almost there!). But we should also point out useful libraries and "spotlighted" projects better. There are already a list of some projects in the "awesome" section.



Thanks also to the people who have written bug reports in the issue tracker. Also, thank you to the people who have written words of encouragement - very welcome amongst a barrage of criticism (most of it constructive, useful, and thought out -- but at other times hostile, jerky or unreasoned).

It's still very much a work in progress, but one where progress is now happening every day. I want pygame to be a safe place where people who make things can create stuff with each others support, and that is what drives me.


cheers, and happy hacking



On Tue, Aug 18, 2015 at 6:57 AM, Ian Mallett <ian@xxxxxxxxxxxxxx> wrote:
âHi,

First, I think it's great that there's been some attention on the site (even if it was a pointer switch). I'm comfortable with early 2000s web design, but I realize not everyone is. The new feel of PyGame is a lot more like something, if I were a neophyte, I'd want to tinker with.

Second, I think it's good that the new site has been made default. This will force dogfooding. We should leave it that way.

However . . . the new site needs work. It took me five minutes to find the documentation, and I still don't know how to add a project. IMO the narrow columns and horizontal scrolling are bletcherous too, but I won't knock the prototype too much, because what I really want to say is that:

I propose that the website model be made more open for everyone to change. I haven't been keeping up with the list, so I apologize if it's been answered, but it doesn't look like https://bitbucket.org/pygame/pygame is the location for the site. That is, ordinary users can't submit pull requests for the site itself. I think this would help us move toward a better website, faster--and one which, by construction, the community would value.

Ian