Skip to main content

How?

This app is designed to provide practical examples for migrating from Ember to React. Here’s how you can effectively navigate and utilize the examples provided within the app:

  1. Examples:

    • Use the sidebar to browse the categorized examples.
    • Categories might include Fragments, Data attributes, or State after you click Examples.

  2. Search Functionality:

    • Use the search bar to quickly locate specific examples by keywords, such as "props".

Types of Examples and How to Use Them​

Component Migrations​

  • Where to Find: Look for sections titled "Component Examples" or similar.
  • How to Use:
    • Explore examples of individual components like buttons, modals, or dropdowns.
    • Compare the Ember implementation with the React version to understand key differences.

Features to Enhance Learning​

Side-by-Side Comparisons​

  • Look for features that show Ember code alongside its React counterpart.
  • Use these comparisons to understand the translation of logic, syntax, and architecture.

Tips for Efficient Browsing​

  1. Start with Simple Examples: Begin with basic component migrations to build confidence before tackling complex features.
  2. Bookmark Useful Examples: Mark examples that align closely with your application’s requirements.
  3. Experiment with Code: Use interactive features to tweak the examples and see how changes affect behavior.
  4. Document Insights: Take notes on patterns and techniques that you find useful for your migration process.

By exploring the examples systematically and leveraging the app’s features, you can gain a clear understanding of how to transition from Ember to React effectively.

How to Contribute​

This app is designed to provide practical examples for migrating from Ember to React, and contributions from the community are vital to keeping the examples relevant, accurate, and helpful. Here’s how you can contribute:

Editing Existing Content​

  1. Navigate to the Example:

    • Use the sidebar to locate the example or section you want to update.

  2. Click the Edit Button:

    • Each example or documentation page includes an Edit button (usually located at the top or bottom of the page).
    • Clicking this button will take you directly to the corresponding file in the repository.

  3. Make Your Changes:

    • Edit the file using GitHub's built-in editor or clone the repository to work locally.
    • Ensure your edits improve clarity, accuracy, or functionality.

  4. Submit a Pull Request:

    • After making your changes, submit a pull request (PR) with a clear description of what you’ve updated.
    • Include a brief rationale for your changes to help maintainers review them efficiently.

Adding New Examples​

  1. Identify Gaps:

    • Look for areas where new examples might help other developers, such as missing patterns, advanced use cases, or commonly requested features.

  2. Follow the Contribution Guidelines:

    • Ensure that your example adheres to the app’s style and organizational structure.
    • Include side-by-side comparisons of Ember and React implementations whenever possible.

  3. Submit Your Example:

    • Add the new example to the appropriate category or create a new section if necessary.
    • Test your example thoroughly before submitting a pull request.

Best Practices for Contributions​

  1. Keep It Simple:

    • Examples should focus on a single concept or feature for clarity.

  2. Write Clear Descriptions:

    • Provide a brief explanation of the example and why it’s useful for migration.

  3. Test Before You Submit:

    • Verify that your code runs correctly and aligns with the app’s goals.

By contributing your expertise and examples, you can help create a valuable resource for developers migrating from Ember to React!