janrain/bootstrap — pull request #15 by thanj (2014-10-08 20:27:47+00:00)
Title: Add a structure to hold documentation / style guide stuff

Hey, I think I've mentioned this idea to all of you before... the concept of keeping documentation and a brand and UI style guide inside the bootstrap repo.

I'm ready to start working on it, so wanted to discuss process. This pull request just re-adds the /docs directory from bootstrap and the Grunt tasks to build a documentation website from that.

This documentation isn't usable yet for a couple reasons:
- The pages in there are just the default TWBS docs, it doesn't include any of our custom elements. Also it still includes a lot of elements we're not using.
- The stylesheet thats in there isn't getting built the same way as the stylesheet in the console: its importing a lot of useless scss files which I built as one-offs for the devportal and missing some stuff which is in other places.

But I just wanted to validate this general approach with you. I'd ideally like to see a base style guide written up here, which I can work with Luke to compile. Once that's in place, it'd be nice if every new UI component which is built gets added to bootstrap and to examples in documentation.

Questions: does this approach makes sense to you? Does this PR look like a good start? Should we plan out process for doing this?