home
  • Blog
1.10
  • Getting Started
  • Getting Ember
  • Concepts
  • The Object Model
  • Application
  • Templates
  • Routing
  • Components
  • Controllers
  • Models
  • Views
  • Enumerables
  • Testing
  • Configuring Ember.js
  • Cookbook
    • Introduction
    • Contributing
      • Introduction
      • Understanding the Cookbook Format
      • Participating If You Know Ember
      • Participating If You Don't Know Ember
      • Deciding If A Recipe is a Good Fit
      • Suggesting A Recipe
    • User Interface and Interaction
    • Event Handling & Data Binding
    • Helpers & Components
    • Working with Objects
  • Understanding Ember.js
  • Contributing to Ember.js
Old Guides - You are viewing the guides for Ember v1.10.0.
Go to v5.0.0

Suggesting A Recipe

Edit pencil

Problem

You'd like to submit a recipe to the Ember Cookbook.

Solution

Fork the repository and create a feature branch named after your recipe. New recipes should have four sections: a title, a problem statement, a solution statement, and an empty discussion section.

Discussion

A feature branch is a branch in a local git repository. Its name should be the camel-cased or underscored name of your recipe. For example, the branch name for this recipe – "Suggesting a Recipe" – would be SuggestingARecipe or suggesting_a_recipe.

The title, problem, and solution of your recipe should match the Cookbook's style (see Understanding the Cookbook Format). While your recipe should include a discussion section, you should leave it blank. These sections will be created in a later phase of the Cookbook project.

The filename of your suggested recipe should be the lowercase, underscored version of your recipe's name. The filename name for this recipe &nash; "Suggesting a Recipe" – would be suggesting_a_recipe.mdown.

When you are ready to submit your recipe, push your local branch to the remote branch on your GitHub fork and submit a pull request. Before submitting a pull request, make sure someone hasn't already submitted a similar recipe and that your recipe is a good fit for the Cookbook (see Deciding If A Recipe Is A Good Fit).

left arrow
Deciding If A Recipe is a Good Fit
We've finished covering Contributing. Next up: User Interface and Interaction - Introduction
right arrow
On this page

  • Problem
  • Solution
  • Discussion
Team Sponsors Security Legal Branding Community Guidelines
Twitter GitHub Discord Mastodon

If you want help you can contact us by email, open an issue, or get realtime help by joining the Ember Discord.

© Copyright 2023 - Tilde Inc.
Ember.js is free, open source and always will be.


Ember is generously supported by
blue