Live data from Hacker News

A redesign of the Django websites

djangoproject.com

81–90 of 100 posts

Re: A redesign of the Django websites

#81

Funny how, even after a redesign, I can still recognize the layout of the docs after occasionally looking at them a few times a year :) https://docs.djangoproject.com/en/1.7/

This is an important point I think. People have been referring to these docs for years and got very comfortable with the layout. I'm glad they kept this part so similar.

Re: A redesign of the Django websites

#82

Good job on the redesign. I think it looks great. How about getting rid of Trac now? There's really no worse issue tracker...

I think that there's too much historical data in Trac for them to ditch it. Migrating would be difficult.

We migrated from trac to jira a couple years ago and it actually wasn't that bad. So glad that we did. Trac works fine for little tiny projects (although these days I would just use github or bitbucket issue tracking). Jira really shines on larger projects though.

Re: A redesign of the Django websites

#83

Earlier quoted context omitted.

Documentation websites actually have some pretty good use-cases to being scalable to mobile, either because people will view documentation on a tablet or phone while developing, or due to people using smaller browser widths when developing to be able to display their IDE or terminal windows next to the documentation windows.

Yeah, no. Smaller browser widths I agree But using a phone/tablet to navigate the docs? Might as well use notepad for coding too, since the objective is to suffer.

Well, the nice thing about mobile first is that the benefits extend to smaller browser widths as well. And just because you don't find a method appealing to use doesn't mean it's not a valid use case. I, for one, like to have all my documentation offline in ePub on a tablet, but that doesn't mean I assume it's the best method for everyone else (or even anyone else).

Plus, though it amy be an unintended consequence, mobile first shouldn't at all hurt the desktop experience, just make sure that mobile is not an afterthought once the design patterns are engrained and it's too late to modify a responsive experience.

Re: A redesign of the Django websites

#84

Earlier quoted context omitted.

Both. It is possible, and not too difficult in fact, to write a single codebase that runs under both Python 2 and Python 3. Which is what Django has done. The same code runs the same under 2.7 or 3.3 or 3.4.

Thanks for the reply. Are there any guidelines or "best practices" for writing code for both 2.7 and 3.4?

Here is Django's documentation, including notes on the compatibility stuff we ship:

https://docs.djangoproject.com/en/1.7/topics/python3/

Re: A redesign of the Django websites

#85
post #23

Looking great. Thanks for great Christmas gift :D On the other hand, I feel like I am going to miss old design - is there archive somewhere?

# apt-get install python-django-doc $ x-www-browser /usr/share/doc/python-django-doc/html/index.html :)

It's on ReadTheDocs :D django.readthedocs.org/en/latest/

Re: A redesign of the Django websites

#87
looks great - doc site is cleaner yet still very familiar. Everything else aside, I'd kill for better doc search - or just simply allowing () to search for functions. Trying to refresh my memory on how the .first() or .latest() method works, for example, requires browsing. no real way to search for it.

Re: A redesign of the Django websites

#88

Overall I like it, but it could really do with a max-width set for the content. I use my browser full screen on a 24" monitor and some of the line lengths are far in excess of readable.

The max-width has been deployed, thanks for the feedback.

a bit offtopic but why is you username highlighted in green?

Re: A redesign of the Django websites

#89
post #7

Earlier quoted context omitted.

I think it has too much empty space ...

Yes, even I thought the same. I hate that the home page has a lot of content that I have to scroll down to view (at 1440x900 resolution). http://ibin.co/1kret3oW7caZ illustrates whitespace wastage in the blog Edit: Added an illustration

> whitespace wastage

there is no such thing. Think more whitespace equals more focus around the content and less clutter.

Re: A redesign of the Django websites

#90

I liked the old site better. This is clearly a case of, "If it ain't broke, don't fix it." The purpose of documentation is utility, not to look modern. It does nothing that I can see to improve the utility. In fact, all of the white space makes it harder to use. It would be nice if there were an older "theme" users could continue using.

Agreed. The site now... looks more like every other site. But why's that a good thing? Old design had a more unique personality -- new one looks very much like a Bootstrap deploy with tweaked colours.
Post reply on HN