bitovi / canjs.com Goto Github PK

I realize the IRC tab on the community page is not done, but I just thought I'd note that currently the "irc-chat-container" div is being duplicated 3 times on that page.

Since all our pages are loaded via JS, it is sometime slow. For me at home, it takes a full 2-4 seconds to go from the homepage to a fully loaded Community page, for example. Part of that delay is BitHub (related: can we cache it so it's not calling live each load?)

Anyway! to the extent that it's possible, I think it would be a good idea to show this loading indicator on every page between loads. Just add the class "active" onclick and then remove it when the page is done loading.

Is that doable?

I added a div at the bottom of the template with a class="loading" and positioned it outside the view. When a class of "active" is added to the div, it will appear just below the main nav... It has a spinning ajax loading indicator graphic inside it to let the user know something is loading.

I'd be even better if we can animate it. By default, the CSS is "top: -100px;" -- if you just set "top:54px;" with a transition, it will slide nicely in from the top.

Change:

"Sleek, lightweight, and responsive: exactly what it says on the can."

To

"Sleek, lightweight, and responsive: exactly what it says on the can. more"

add the more link for each button's text.

DoneJS -> JavaScriptMVC
JQuery++ -> jQuery++

If you press the enter key on your keyboard, it does not search the forums. If you click the search button, it works fine.
http://localhost:3022/canjs.us/_development/index.html?#!community

The design for the homepage carousel of featured apps calls for the thumbnails to be greyscale by default and fade to the color thumbnail on hover. I had this working with an old js plugin that doesn't work with new versions of JQuery, but I'd like to still implement this. The color thumbnails take away too much from the rest of the design (imho) since there are no other photos like that on the page.

main issue: #26

The initial value for the CDN link is:
//cdn.canjs.com/releases/1.1.5/can..js (extra dot needs to be removed?)

Yet, JQuery is the default selection in the dropdown menu, but it doesn't seem to be the JQuery version? Seems like maybe we need another dropdown option like "Default" or maybe make the default link the JQuery link:
//cdn.canjs.com/releases/1.1.5/can.jquery.js

Can we add the ability for the tabs on the community page to have a url? Current community page URL is something like: http://bitovi.github.io/canjs.us/_development/index.html#!community

Could something like:
http://bitovi.github.io/canjs.us/_development/index.html#!community,irc automatically make the IRC tab active?

It would be nice to have urls for each tab

main issue: #26

There is an issue with the Lato font, weight 700, Bold, where the x-height of the bold font is taller than the regular. As a result, strong tags inside regular text makes the text seem rendered incorrectly. It may just be a limitation/problem with this particular font. But I'd like to see if there is any workaround, like applying a different weight or letting the browser bold the font instead of using the font itself. I played around with it already and have no come to any conclusion yet.

For an example, see: http://localhost:3022/canjs.us/docs/can.Control.prototype.destroy.html bolded text within the paragraph tags under Teardown in Destroy

It looks like all the data we're pulling from Bithub on the community page is sorted by newest/latest content, not the top rated content. It should only show the top-rated content.

This is an issue. David likes to close issues. This issue has been posted so David can close it and get the personal satisfaction from closing an issue. After all, it's Friday!

When I click the "customize" button on the homepage and hover into the download builder, the Customize button should remain dark green the whole time, until I click off of it

The checkbox for "Core" should be checked by default, since all the options underneath it are also checked by default.

Currently, clicking that checkbox doesn't do anything since all the options are already checked. You have to click twice to unselect those options

We aren't getting source_data from the API, so parts of the community page are missing (e.g. twitter icons).

From the current site: http://canjs.com/#developing_canjs

Main issue: #26

Get rid of the Videos page when only has one Video. We can either move it to:

• Getting Started with CanJS
• Guides index.html

Main issue: #26

1. Main nav position is off
2. Bottom wizard guide arrows "missing"
3. Download page: Library dropdown too small. change to default
4. API Search icon missing, text field not working?

What do you think of making the field with the CDN link select all the text when a user clicks on it? So it's easier to copy/paste. Do you know what I mean? When you click, it selects the whole line for you. Maybe that's annoying to some users.

From:

We can
do JavaScript better.

To

We can do
JavaScript better

I know it removes the emphasis on can, but might space things a little nicer. We could bold can J and S if we want to beat people over the head with it.

I can't figure this out. If you hover close to the CanJS or Bitovi logos, the menu pops up before you're hovering over it. I've looked at the code/inspector and the a tag seems to be the right size. Why would the menu be active just getting close to it? Maybe the HTML needs to be different?

Any ideas?

This appears only to happen in Firefox. I've taken a look and I'm not quite sure what's going on here. Maybe it has to do with the custom font you're using, Tom?

main issue #26

Also, make it a link to the YouTube video, not embedded.

parent #26

Maybe it looks like "for [jQuery]"? or "Library: [jQuery]"

Some times the .sidebar's width is collapsing below it's set width, this seems to happen when the content has wide pre tags.

http://beta.canjs.com/docs/can.Control.prototype.destroy.html

1. Bullets - too indented
2. strong tags font size is strange
3. tags text is too small and character spacing funky

Because of all the generated files changing all the time the repository is getting rather big quickly due to the development activity.

We need to remove the history of all generated files for the first release of the site. See here how.

Also disable the generated file debug mode for the release.

the nav for the API needs to be re-designed to accomodate:

1. Expand/collapse each element without selecting it.
2. Search results to better show parent/child relationship

Not a bad idea. First brought up in issue #27.

Should be designed like the fix for #40

If I go to the download builder, check can.Mustache, and download, the can.custom.js file I get does not include can.Mustache.

Here's the URL the can.custom.js file is from: http://bitbuilder.herokuapp.com/can.custom.js?configuration=jquery&core=can%2Fconstruct%2Fconstruct.js&core=can%2Fobserve%2Fobserve.js&core=can%2Fmodel%2Fmodel.js&core=can%2Fview%2Fview.js&core=can%2Fview%2Fejs%2Fejs.js&core=can%2Fcontrol%2Fcontrol.js&core=can%2Froute%2Froute.js&core=can%2Fcontrol%2Froute%2Froute.js&plugin=can%2Fview%2Fmustache%2Fmustache.js

Twitter Bower needs a remote repository to install components.

We need to move all the release files to the master branch of this repository and tag each version. This will also allow us to use the ZIP/TAR downloads generates by GitHub for each version as the main download instead of having to create our own.

The nav (both header and footer) need to have a class of "active" added when the user is on that page. The nav element gets the same style as the hover effect when this happens to make it clear at-a-glace what page the user is on. This would be true for all children pages too, so if the user is buried deep in the API, the API menu item will have a class="active"

I think the download builder dropdown on the homepage should close when clicking somewhere on the page outside of it and also once I clicked the download button.

This is almost identical to the issue with FF cutting off the Bitovi logo. I can use the same fix, but since the Can logo is so much bigger... I might opt for an image for IE8 instead so as to not mess up the other browsers...

the last two plugins on the DL page require JQuery, so we need to add a class="inactive" to the s for those if a user selects a different library. Same on the homepage downloader.

The page heading listing currently links to e.g. http://beta.canjs.com/docs/can.Model.html#new%20ModelConstructor(%5Boptions%5D) which seems to trip all browsers into doing weird things.

The guides page is pretty basic, but it needs to be cleaned up and made to look better.

For example: http://beta.canjs.com/docs/can.Model.html#new%20ModelConstructor(%5Boptions%5D)

It looks like .container.api { overflow: hidden; } is causing this, but disabling that screws with a lot of other things that will need to be fixed.

git-subtree is used to keep the can folder locally in sync with upstream. The local changes need to be merged back into the upstream 1.1.5-docs branch.

For the page release, that branch needs to be merged into CanJS master.

I think the guides menu needs to contain some additional points (like contributing guide, changelog etc.). This is the structure I was thinking about for now:

• Get started (include the video here? A separate page for a single video seems overkill)
• Recipes
• Why CanJS
• Using CanJS (see that section on the overview page)
• FAQ (?)
• Contributing (use contributing.md used by GitHub)
• Changelog (use changelog.md)
• License (should be on every homepage somewhere)

@matthewp also suggested to put the guides in the Wiki which I think is a great idea. We just need to investigate a little how to do that best (adding them as a Git subtree is easy because the Wiki is its own repository).

Issue #23 is also related to this.

1. Create a better demo that uses new syntax new Todo.List({}) and show adding and removing todos.
2. Syntax highlighting
3. Link to a JS fiddle.

Many links in the guides that should go to the API don't. These need to be found and fixed.

http://localhost:3022/canjs.us/docs/cached.html returns a 404

This is linked from: /canjs.us/docs/can.view.hook.html sidebar can.view > cached

I noticed on this page: http://beta.canjs.com/docs/can.view.register.html

There are some empty p tags just above and below "Information about the templating language." in the HTML. Probably extra lines in the markdown? But either way, we should remove them or not print them to the page.

This should be the same as the homepage where the active tab is orange. Currently, they are only orange on hover.