Skip to content

Latest commit

 

History

History
112 lines (63 loc) · 3.45 KB

CONTRIBUTING.md

File metadata and controls

112 lines (63 loc) · 3.45 KB
Raw

Contributing

First of all, thanks for wanting to lend a helping hand to this open-source initiative. The more we are the faster we'll lunch so any help counts ^^^

Secondly, for now you can contribute in 3 ways:

  1. Coding for the platform
  2. Writing HTML lessons
  3. Writing HTML exercises together with their solutions

Regarding the first point have a look over the issues tab and see if you can find anything there you might one to implement.

For points 2 & 3 get in touch with us via social media or email at [email protected]. Also check out Diana's guide on how to code a new lesson.

Commit Messages

Every commit message should have an associated issue that describes the feature/bug/idea in more details.

The name of the commit should follow this format:

{issue_name} ({issue_url})

For example, the commit message for this issue: #297 should be:

Upgrade to Next11 (https://github.com/FrontEnd-ro/frontend.ro/issues/297)

Exceptions

If we have commits that are only COSMETIC (ie: changing formatting but not actual code), we can simply name them by prepending [COSMETIC].

Example: [COSMETIC] Fix eslint warnings.

FrontEnd Style Guide

As most guides, this one is opinionated. The goal is not to find the best patterns, we'll grow old and never agree on the answers.

Instead we want to compromise on some good enough patterns so we increase productivity and keep everyone sane.

[Redux] Action names

Name actions using present tense*

users/ADD
users/UPDATE
users/REMOVE

*However , in case we have situations where multiple parts of the app are interested in the fetch start/end/error events of some resource, let's move this into the store and use past tense for the actions:

users/FETCH_STARTED
users/FETCH_SUCCEEDED
users/FETCH_FAILURE

[Redux] Keep UI State as low as possible

Loading states for example. Let's not move them into the store unless multiple components need them.

Otherwise let's keep them in the local state of our components.

Folder & file names

Use PascalCase for components and SCSS module names.

Add an index.ts file inside each component folder which exports the Component so we can easily import it without duplicating names in import path.*

/TableOfContents
  index.ts
  TableOfContents.tsx
  TableOfContents.module.scss

import TableOfContents from '~/components/TableOfContents'

* exceptions to the above index.ts rule may happen when we have multiple smaller components that are probably gonna be used together all the time: see /lessons folder

Overall styling

We use a combination of CSS Modules and utility classes in the TailwindCSS naming format.

A combination of both allows us to declare complex styles for certain componenta, but also apply small, specialized modifications via utility classes.

The TailwindCSS naming format is important for keeping a community-level standard. This way, when new people join the project they can easily understand the class names and add new ones.

Made with ❤ by the open source community!

Email | Twitter | Facebook