search

assemble / assemble.io

Website and documentation for Assemble.
http://assemble.io/
Other
81 stars 48 forks source link

Homepage #95

Open jonschlinkert opened 10 years ago

jonschlinkert commented 10 years ago

Tracking issue to discuss the home page for assemble.io. v0.3.0

General goals

pburtchaell commented 10 years ago

Before we start talking about design, perhaps we should build out a list of requirements for the homepage?

I think I remembered you mentioning on an issue something about featuring projects that use Assemble, but that is about it.

jonschlinkert commented 10 years ago

Agreed! The homepage never got the time and attention it deserved, but the goal was to stay mostly gray-scale and let community projects "bring out the color". I still like that concept a lot.

Beyond that, I'm open to anything. So even the following is just a suggestion, but I think a good, general structure would be:

image

Also, time permitting, @somerandomdude is going to contribute some large icons for the area below the masthead. In which case we'll probably add a row of large icons above or below the "getting started" row, where each icon would represent a major Assemble concept, e.g. "layouts", "pages", etc.

thoughts?

jonschlinkert commented 10 years ago

it might be cool to use an opaque image behind the masthead too. so basically the masthead would stay black, but there would be an opaque image behind it, but that's just an idea.

Also, there is the restriction that the home page will need to feel visually aligned with the rest of the docs (here are some previews https://github.com/assemble/assemble.io/pull/77, but you can pull down the v0.3 docs and see them live as well. i'm happy to help if you have any issues). hopefully that's okay

pburtchaell commented 10 years ago

This looks good to me; when are you planning to launch the new site?

jonschlinkert commented 10 years ago

after we get everything checked off, there is still a lot to do

pburtchaell commented 10 years ago

Sounds good. Also, what are your opinions on showing recent contributors to the project and the last commit on the homepage? Like MDN and Foundation.

jonschlinkert commented 10 years ago

Love the idea! I really like how foundation does it (stylistically). I'm a big fan of showing appreciation for the developers that make assemble what it is! any idea along these lines will always be welcome.

pburtchaell commented 10 years ago

Okay so I finally have some time to get this started.

I ran grunt and everything was compiled successfully. I noticed however that there is not a homepage at the moment in _gh_pages (unless I am just looking in the wrong place). Am I starting from scratch then or is there the pre-existing homepage I should start from?

jonschlinkert commented 10 years ago

Sorry, I only defined helpers.hbs in the Gruntfile b/c that's what I was working on: https://github.com/assemble/assemble.io/blob/v0.3.0/Gruntfile.js#L119. Just change it to index.hbs or *.hbs or whatever makes sense. thanks!!

pburtchaell commented 10 years ago

Alright, I was able to get this started today, but I am having a hard time navigating all the less code lol. Where would typography and link styles be located?

jonschlinkert commented 10 years ago

styles are organized into components. (There are unused components in the components folder that I'll clean out later.)

All of the styles above should be common, reusable and generalized as much as possible.

pburtchaell commented 10 years ago

Okay thanks, I was able to find it. What are your thoughts on merging some of the components together (like merge btn.less together with btn-social.less and btn-outline.less)?

Also, lately, I have been creating a "views" folder to store components that double as UI elements in. For example, the header.less, footer.less, masthead.less, sidebar.less and page-nav.less files could go into the views. Just an idea.

jonschlinkert commented 10 years ago

looks like my email reply didn't make it here... for now let's keep them separate so I can just clean out the files that aren't being used instead. Sure, you can move those to views if you want. no prob thanks!