How can point people to the great resources around the web for Bourbon?

A few:

• https://robots.thoughtbot.com/tags/bourbon
• https://thoughtbot.com/upcase/bourbon-smash
• https://www.git-tower.com/learn/bourbon-neat-bitters/getting-ready/introduction
• http://thoughtbot.github.io/proteus/

SassDoc doesn't support rich “demos”, like we have in our existing documentation. One way around that could be for Middleman to look through a directory of partials and if it finds one with the same name as the feature, inject it in. Similar to how the Refills site works.

https://thoughtbot.com/open-source-code-of-conduct

• Netlify (+ how to login)
• Auto-deploy from master

Dependabot can't resolve your Ruby dependency files.

As a result, Dependabot couldn't update your dependencies.

The error Dependabot encountered was:

Bundler::VersionConflict with message: Bundler could not find compatible versions for gem "coffee-script":
  In Gemfile:
    middleman was resolved to 4.2.1, which depends on
      coffee-script (~> 2.2)

Could not find gem 'coffee-script (~> 2.2)', which is required by gem 'middleman', in any of the sources.

If you think the above is an error on Dependabot's side please don't hesitate to get in touch - we'll do whatever we can to fix it.

You can mention @dependabot in the comments below to contact the Dependabot team.

Should this repo be deleted?

It seems like the actual bourbon.io site is hosted from the gh-pages branch on thoughtbot/bourbon

(Pinging @tysongach)

Hi! Apologize in advance if this is a silly question, but I noticed that the only way to access the Bourbon 5 docs is to build them from this repo and run locally.

Are they online anywhere? The bourbon.io website still lists 4.x but with ~90% deprecation warnings:

Thanks in advance!

When we launch 5.0 and the new website, we need to keep the 4.x documentation available.

Current thought is pull a static copy of the HTML & CSS for http://bourbon.io/docs/ and include it as an isolated page here in the new website. No need for it to intertwine with the new styles here.

Could be useful to add a banner at the top that indicates that it is not the current version.

Add “Open in CodePen” links for each feature so people can easy play around with the feature.

Dependabot couldn't verify the SSL certificate for https://rails-assets.org/.

This is most likely to be because https://rails-assets.org/ doesn't have the CA certificate needed for verification.

You can mention @dependabot in the comments below to contact the Dependabot team.

We currently publish the docs to Dash and we should account for this with the new website, as well.

Currently, running the Rake task to generate docs for an alpha or beta version, you get a SassDoc warning:

[WARNING] SassDoc could not find anything to document.

The generated JSON file (e.g. bourbon_5_0_0_beta_6.json) contains no data.

Also, the Version class does not recognize alpha or beta.

Automatically import Bourbon’s change log when generating the docs.

The "view source" link is refering to https://github.com/thoughtbot/bourbon/blob/master/app/assets/stylesheets/functions/_linear-gradient.scss and the correct is https://github.com/thoughtbot/bourbon/blob/master/app/assets/stylesheets/css3/_linear-gradient.scss.

https://devswag.com/products/bourbon-family-sticker-bundle-4

For a moment I thought the ice cubes actually moved slightly, wiggled. It would be awesome if they really did so.

Currently, our Rake tasks accounts for released versions of Bourbon, i.e. the version specified in the Gemfile, or a specific version via rake generate_for 5.0.0.

What do I do if I need to fix a typo in the docs after they've been released? We shouldn't have to force a new Bourbon release just to fix a typo.

Could we generate straight from master? Or by passing a specific commit SHA?

I'm on an iPhone running iOS 8, and the navigation sidebar doesn't render properly, when I begin to scroll to the right to look at the content, the sidebar obscures the content. It slides to the left, but not fast enough.

From http://bourbon.netlify.com/docs/5.0.0/#triangle
@include triangle("up", 2rem, 1rem, #b25c9c);

Should be...
@include triangle("up", #b25c9c, 2rem, 1rem);

@whmii Do you have a working list?

This is a 'know issue' but we may/probably want to update the tagline for Bourbon from:

A simple and lightweight library for Sass.

While the change log is quite useful and specific, it could be worthwhile to have a simple “Upgrade to v5” page on the website for awhile which would cover all the major changes in a digestable way.

from an outsiders perspective, it does not seem possible to discern what is a component vs what is a pattern. If there is a difference, it seems more philosophical than practical.

Also, components are imported after patterns. I understand this is in the realm of opinion but a component is a…

a part or element of a larger whole, especially a part of a machine or vehicle

while a pattern is a…

regular and intelligible form or sequence discernible in certain actions or situations

There for a component is a part while a pattern is an assembled group of things in a repeated method. I think we should move more toward components being parts and patterns being collections of objects.

I would assume that we are going to end up forking this repo and creating 3 repositories for each of the 3 libraries. Sounds scary but it'll probably work.

One question that I have is if we plan on releasing updates to the 3 repositories simultaneously and how far we should take this repo before we fork it.

The other is what will the bitters page be? the old site wont work and the project doesn't really have "documentation"

This was brought on by the realization that Neat 2.0 will basically remain unusable, even if it is in a beta state, until there is some level of documentation accessible by the web.

I have a file called main.scss, where I dump all of my imports from around my project.

I was trying to update styles in one of my files, but it didn't work, so I went to test it in my main.scss file by updating the background color there, and it still didnt work. I commented out @import bourbon/_bourbon, and it worked. I have browsersync enabled and I traced the error back to the bourbon/helpers folder:

Can someone give me some insight in what I may be doing wrong? Even if I completely remove the file that has the error, another file in the folder gives an error, and so on.

Thanks!

• In each repo:
  • https://github.com/thoughtbot/bourbon#the-bourbon-family
  • https://github.com/thoughtbot/neat#the-bourbon-family
  • https://github.com/thoughtbot/bitters#the-bourbon-family
  • https://github.com/thoughtbot/refills/#the-bourbon-family
• https://thoughtbot.com/tools#front-end
• http://stackoverflow.com/tags/bourbon/info
• https://github.com/thoughtbot/suspenders#gemfile

I think it would be good have the first section be the docs for the $bourbon settings variable (I mean, until we add some installation instructions sections). Right now it is kind of buried.

I think we should have a section for 'settings' and then what ever we decide for the res of them, 'Functions and Mixins'? ¯_(ツ)_/¯

I think it’d helpful to use the content on the home page to really speak to why Bourbon is the way it is.

Bourbon is a tool for making awesome projects on the web…

We could swap “Bourbon” for just about any project or product, and the sentence would still complete. How can we get this to place that succinctly explains why Bourbon is a great tool to use, and help people understand why.

Riffing on some thoughts and ideas around this:

• Pure Sass, no other dependencies
• Clarity over brevity
• Human readable syntax
• Part of a larger suite, modular/nimble
• No output on install
• No visual opinion