codemontagehq / codemontage Goto Github PK

Need to preload tags of projects in Organization show page.

Description
Projects are currently ordered in the worst possible way: by the database. We can do way better, both incrementally with data we have through the Github API and eventually with data we'll get from Coders, Github, and Organizations.

Ask
Share your thoughts on how you'd like projects to be organized in a comment on this issue.

Additional Info
Ideas (wide open for discussion):

• By the project's most recent Github activity
• By the project's number of Stargazers
• By if the project uses a technology the user is interested or skilled in
• By time to install (#152)
• By code complexity (#152)

This is to correct GitHub capitalization in the database. Sometimes you see GitHub Spelled as "github" or "GitHub", where the proper capitalization would be "GitHub".

The application's secret token shouldn't be in version control, but can be a hassle to add to .gitignore and still deploy to Heroku.

Check out this secret_token.rb example and these methods for Heroku on RailsForum

On the project submission page, other required fields are designated as required with a *. GitHub organization name is required for public submissions (though not for admin submissions), so should be shown as required as well.

Related to #135 & #158

This Profile & Account Settings page (http://codemontage.com/settings) could use a lot of changes, but a really helpful first step would be to stop the page from automatically focusing on the email address field, since it's not the most likely field to be updated by the user. I believe it does this because the field is required (as established by devise).

e.g.

Description
Right now, the Organizations index page looks a mess.

Ask / To Do

• Clean up the formatting and design of the Organizations index.

Additional Info
Please use Zurb Foundation standards and classes. The block grid might be particularly helpful here.

Tips from @bmartinstudio :

• Force height of the org logo element so the grid is maintained. 150 px height would work pretty good.
• For the taller logos, set the max-height to 150 as well.
• In a perfect world, this list would be a list as well.

Description
Currently new Projects can only be created for new Organizations. Existing organizations must contact CodeMontage directly to add a new project to the platform.

Ask / To Do

• Adjust project submission form to allow existing organizations to submit new projects from the "Submit a Project" button below

Additional Info
Follow-up to #122 Add Project Submission, suggested by @courte

Description
Our current 404 page leaves a lot to be desired. It is a rails default and does not show that you are on the CodeMontage platform or allow you to click a link to return to an existing page.

Ask
Create a 404 page that better represents the platform and gives users an out to other locations on the site.

To Do

• Create a custom 404 page

For organizations running social good hackathons and hoping some of the projects continue, share content based on our experiences running and supporting social impact projects.

Include Open Source Project Setup: Continuing Your Hackathon Project

Upgrade Image Handling to Use S3

• Upgrade Image Handling to use files instead of URLs (#88)
• Create an S3 account (@DBNess)
• Update Paperclip config (Heroku help doc)
• Migrate currently used images to S3

User Favorite Projects have been created in the database, but not yet enabled on the frontend.

Need to upgrade Foundation from V3 to V5, possibly through V4 first.

References: Upgrade guidelines from Zurb Foundation V4 to V5

Throughout site, we tend to use "github" or "Github" when proper usage would be "GitHub"

Description
I created an account for Coder Day and signed on through GitHub. Then I tried to set a separate CM account password and couldn't. If I remove GitHub auth, then I can't use my CM account at all. I'm not sure that's a good thing.

Ask
Allow users to remove GitHub authorization while still maintaining their CodeMontage account.

To Do

• #303

When hovering, the background for the button below turns entirely white before turning to the hover color of lightened $cmPurple. What's that about?

cc @bmartinstudio who has taken a look at this

Trim down code for AdminUsers by building off of Users.

References:

• Stackoverflow Tip

Use the project_tags_link_list helper to display Causes and Technologies for projects in the Organization show page.

http://zurb.com/playground/foundation-icon-fonts-3

Description
For a 5 hour coding event you don't want to spend 2 hours setting up a project, while for a 2 day event you will.

Ask
It will be helpful to sort projects by their complexity/time to install as well as by code complexity (beginner, intermediate, advanced) to better tailor to different types of users and events.

Additional Info
Related to #57.

Wouldn't it be nice to center align the stuff in the footer?

One below other?

Would be cool to quick-link to the projects waiting for approval from the /admin dashboard.

Follow-up to #121 Add Project Approval

Would be nice to have a link to the github repo in the header in addition to twitter, facebook and tumblr. Since I have not found a single link to github (not sure :) ), it would be a nice addition.

Coder Day of Service Logo files on Google Drive

Add environment configuration for a Staging setup, including:

• Create config/environments/staging.rb
• Create Google Analytics staging profile
• Add Google Analytics tracking code to staging.rb
• Add Google Analytics environment variables to Heroku

Simplify & Improve the Submit a Project Form UI
e.g. possibly by combining Organization & contact details onto one line each?

Follow-up to #122 Add Project Submission, suggested by @courte

Description
Currently users need to input their GitHub username/organization and GitHub repos separately in order to create new projects.

Must of our work with Projects is based on these two inputs, which are often input incorrectly. If users could input a GitHub url, it would be much easier for everyone involved.

Ask / To Do

• Add support for GitHub URLs, so user can enter a something like http://www.github.com/codemontagehq/codemontage and we can 1) check that it's valid, 2) parse it into a GitHub organization + repository in the database.

Additional Info
Follow-up to #122 Add Project Submission, suggested by @courte

Improve the Sign Up page with a better looking UI (and more compelling calls to action to use GitHub or email + password), like @visnupriya did for the Sign In page in #198

Example:

Its is better to show validation error messages in different colour.

1. /auth/login
2. /auth/password

Preferably red colours.

From outside, i.e. https://www.codemontage.com/organizations/new Organization GitHub account should remain required.

From admin, i.e. https://www.codemontage.com/admin/organizations/new Organization GitHub account should not be required.

So that http://blog.codemontage.com might look more like http://www.codemontage.com

Make form validation failure alerts more obvious

For example, on the project submission page, if you submit without a GitHub organization (labeled Organization GitHub Username here), you get an awkward next-line message of "can't be blank" that is indistinguishable from the next field's label.

Make #55 (Add Technology Filtering to Explore Projects - Frontend) work actually change projects shown on page.

In progress in revamp-projects-list branch (on DBNess and root)

Ask / To Do

• Update CodeMontage to run on the latest stable version of rails.

Additional Info
http://www.ready4rails4.net/

Add Coder Program Application

Data collected (per program application) includes:

• Courses
• Books
• Introduction
• How'd you hear about us?
• How pumped are you to become a better software developer?
• What best matches your comfort level with the following programming languages? [HTML, CSS, Java, JavaScript, PHP, Python, Ruby]
• Preferred Language(s) to Practice

Note: A coder can apply to the program many times.

Add Case Studies / Featured Projects

• Case Studies (Featured Projects & Coders)
• Organizations (Profiles, Links to Case Studies, Active Projects)

Once we open up the job board beyond the current, small community, we'll need navigation and filtering and/or search functionality to navigate the opportunities.

We use image URLs instead of adding the image to our own assets all over the place, this is whack and should be better.

Idea:
Use Paperclip

Ask / To Do

• Add client-side validation introduced for organizations by @surendrans in #166 to the account settings page (for logged-in users).

Description
Pull together (from existing but mostly unshared resources) a comprehensive guide to CodeMontage site design conventions. This guide should be accessible and understandable to new contributors so that anyone might contribute to the codebase while keeping the site aesthetic consistent.

Please also include notes on code resources for style and design, such as the colors stylesheet with color palette variables and references to Zurb foundation framework features.

To Do

• Create a guide to CodeMontage site design conventions.
• Include CodeMontage logo and color palette
• Include references to Zurb, the colors stylesheet, and other code resources

Additional Info
References: http://24ways.org/2011/front-end-style-guides/

Include:

http://about.travis-ci.org/docs/user/build-configuration/

Create Coder Profiles

Data collected includes:

• Name
• Email Address
• Gravatar
• Goals
• Causes
• Technologies

We currently use empty columns to create whitespace, but this should be part of the container styling logic instead of repeated on each page.

Refactor code snippets like this (from the index page):

  <div class="one column"></div>
  <div class="panel radius shadow ten column">
...
  </div>
  <div class="one column"></div>

Related to #99 Upgrade Zurb Foundation

This will make the org page much more of a dashboard for all of the active projects. This is not a replacement for the project pages. When the user clicks through, I am assuming integration with github will show the most recent activity for the project on the detail page.

Mostly I like this idea as it puts the causes front and center.

Projects should also sort by most active.

Project submission currently creates an email to projects@, which sometimes causes janky email errors. Make a form that accepts a github account + repo instead.

Let's explain #CodeGoodSunday powered by CodeMontage

Crafted by @sarony & @courte & @DBNess.

Description
We want CodeMontage to be an inclusive community that meets the needs of a diverse group of users. In order to confirm this, we'll need user-generated demographic information.

Ask / To Do

• Allow users to volunteer background information that will help us ensure a diverse community.

Additional Info
Example questions include:

• Which gender do you most identify with?
• Which race(s) do you most identify with?
• What age were you when you started coding?

Many projects have their own dedicated URLs - let's showcase them!

Add a reference to the source of the skills-based volunteering stats mentioned on the Coder Day page:

• 94% of people who volunteer their skills are happier in their jobs [1]
• Skills-based volunteers are 142% more likely to report job-related skills-gains [2]