Enhancements
Closed this issue · 8 comments
Over the Christmas break, I'm going to dedicate some time to enhancing styleguides.io. Is there anything you'd like me to work on in particular?
Wonderful, @maban!
I think a feature that would be helpful for a lot of people would be the ability to filter tools (http://styleguides.io/tools.html) by technology type. Lots of people ask me "Do you know any good ruby (or similar)-based style guide tools?" So that could be helpful!
I'll have a think about other stuff. Thanks for dedicating the time to this! Wish I could do the same :p
Ahh yes, good idea @bradfrost! We have tags for examples, so could use the same functionality there.
I'd like to rework the filters, because they work ok but it's hard to tell which are on/off without resetting. They could definitely be abstracted to work for other content types.
Other ideas:
-
In the card grid, the floats/clears are a bit messy (especially with filters on). We could update the card grid with flexbox and get nice uniform-height boxes that always wrap properly.
-
The home page is a monster (881 list items). It's hard to get a broad sense of what's in the site because you have to scroll so far to see each section heading. We could reduce this to one card per section with a short paragraph + compact list of starred content + link to full section list. I think that'd be more inviting to explore (at the expense of one giant index to use "CMD + F" on).
@brendanfalkowski I'd love to apply some more styling to the filters to make the on/off state clearer, and make them more clickable. I can try and abstract them myself, unless you're eager to work on it. 😀
- Yes! I'd like to maybe use Grid as well, since it's coming to browsers soon.
- Ugh, totally. That'll be my priority. I had no idea we'd get so much content! Good problem to have, though.
I've made some quick and dirty updates, in particular to the filters (now using tags, at least for the moment, because filters make more sense for when you have lots and lots of tags). It's using jQuery which I'd like to convert into vanilla JS.
I've also restricted the number of items on the homepage to only show the recommended resources, although I like @brendanfalkowski's suggestion of enhancing it further. I hope to get round to that.
Still going, moving onto the grid styles so they work better when the tags are selected.
Progress…
Just pushed some more changes to prod. Making more improvements.
Ok, all enhancements requested are live. I need to clean up the code a bit, there's a lot of messy inline scripts and stuff.