Skip to content

tweaks to the category css #1761

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

Merged
merged 5 commits into from
Oct 2, 2018
Merged

tweaks to the category css #1761

merged 5 commits into from
Oct 2, 2018

Conversation

devoncarew
Copy link
Member

  • tweaks to the category css

screen shot 2018-09-24 at 1 31 49 pm

We may also want to reduce the number of colors? Or, use the same color for all categories?

@jcollins-g

@googlebot googlebot added the cla: yes Google CLA check succeeded. label Sep 24, 2018
@jcollins-g
Copy link
Contributor

Hmmm, I tried to do something like this once but it tended to give extra space below the line, which looks a little funny in a mixed list of classes with and without categories. I take it this version does not do that? Can you give a screenshot of a single class in a big list so we can compare the line spacing?

@jcollins-g
Copy link
Contributor

Also, a screenshot of the class page for BaseForDocComments would be good, as that's a different context for this style that matters.

@jcollins-g
Copy link
Contributor

The point of using colors was to make the categories visually distinguishable in pages not necessarily sorted by category. However, I'd be willing to dump colors entirely if we follow @nex3's suggestion in #1681.

There's sort of a tug of war between designs here: are categories more like folders, or like tags? I've implemented them almost entirely as though they were tags, but some sort of hybrid between the two may be more intuitive.

@devoncarew
Copy link
Member Author

screen shot 2018-09-24 at 2 35 23 pm

@devoncarew
Copy link
Member Author

I think it's harder using color here for different categories, when the color isn't meaningful to the category, but just randomly assigned. Sounds like there may be some iteration about whether categories should be more like tags or folders - whatever falls out from that discussion may inform whether colors should be used or not.

Copy link
Contributor

@jcollins-g jcollins-g left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM if tests pass

@nex3
Copy link
Member

nex3 commented Sep 24, 2018

I (obviously) would like to use them as folders. My primary use-case for categories is taking large lists of members that are sorted alphabetically by default and providing more semantic groupings for them. Alphabetical sorting is a reasonable default, but it's almost totally useless for locating the member you want--if you know the name, you're probably just going to use the search bar anyway.

@devoncarew
Copy link
Member Author

@jcollins-g, I'm having trouble getting the tests to pass; I ran grind update-test-package-docs; is there more to do re: golden output files to regen?

@jcollins-g
Copy link
Contributor

jcollins-g commented Sep 25, 2018

@devoncarew Greg's upcoming PR has an updated CONTRIBUTING.md with the instructions:
https://github.com/dart-lang/dartdoc/blob/2056fe10d02a203be6ea47029d88652f915c7936/CONTRIBUTING.md

@devoncarew devoncarew merged commit 2703ce5 into master Oct 2, 2018
@jcollins-g jcollins-g deleted the categories_css branch November 27, 2018 17:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
cla: yes Google CLA check succeeded.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants