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

Better screen real estate usage in multi-package dartdocs #1146

Closed
yjbanov opened this issue Apr 12, 2016 · 4 comments
Closed

Better screen real estate usage in multi-package dartdocs #1146

yjbanov opened this issue Apr 12, 2016 · 4 comments
Assignees
Labels
customer-flutter Issues originating from important to Flutter P3 A lower priority bug or feature request type-enhancement A request for a change that isn't a bug

Comments

@yjbanov
Copy link

yjbanov commented Apr 12, 2016

Flutter publishes its dartdocs as one site for all packages. It now look great! However, there's an opportunity to use the screen space more economically. Specifically, there is some redundant information in the header that increases the height of the header unnecessarily. Below is the screenshot with sections highlighted in red that could be removed without losing any useful information but shrinking the header size considerably:

flutter-docs-screen-real-estate

@sethladd
Copy link
Contributor

Good catch. It's not only duplicate, but incorrect. It's not really a "package" anymore. Maybe, if the categories are used, we can eliminate the word PACKAGE in the header, at least on the homepage.

@devoncarew
Copy link
Member

I could see it being more condensed vertically. It would be nice if it lined up with the header size for https://flutter.io/ so that the page didn't jump around when you move from one part of the site to another.

This main dartdoc landing page doesn't use the space in the header for as many things as the follow on pages (a library page, or and class page). We'd want to decide if we need that content for the sub-pages. I do want to keep the header height for the various generated dartdoc pages the same, so that the header size doesn't jump around as you navigate through dartdoc pages.

@devoncarew
Copy link
Member

We could probably get pretty far here just with some small changes to our stylesheet.

@devoncarew devoncarew added the customer-flutter Issues originating from important to Flutter label Apr 13, 2016
@Hixie Hixie added type-enhancement A request for a change that isn't a bug P3 A lower priority bug or feature request labels Jun 16, 2016
@devoncarew devoncarew self-assigned this Jul 23, 2016
@devoncarew
Copy link
Member

largely addressed - closing

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
customer-flutter Issues originating from important to Flutter P3 A lower priority bug or feature request type-enhancement A request for a change that isn't a bug
Projects
None yet
Development

No branches or pull requests

4 participants