Skip to content

Latest commit

 

History

History
33 lines (27 loc) · 2.21 KB

CONTRIBUTING.md

File metadata and controls

33 lines (27 loc) · 2.21 KB
Raw

Contribution guidelines

This is an open and collaborative project, and any suggestions for improvement are very welcome.

If you're making a pull request, please ensure it adheres to the following guidelines:

  1. Check if the link is working and pointing to the right location.
  2. Check your spelling and grammar.
  3. Choose the corresponding section.
  4. The list, after your addition, should be sorted alphabetically.
  5. Make an individual pull request for each suggestion.
  6. If you use a text editor to fashion the pull request, make sure your text editor is set to remove trailing whitespace.
  7. New categories, or improvements to the existing categorization, are welcome.
  8. Search previous suggestions before making a new one, as yours may be a duplicate.
  9. Use the following format for the commit message: Add Company Foo.io (without 'awesome' or something else).
  10. Keep descriptions short, sweet and to the point.
  11. Use the following format: [Name](link) - Description. keep the length of the name + description under 100 characters
  12. Don't use any vague marketing language. Instead, use objective wording aiming to optimize word greppability. For example, if one wants to find Python jobs, or to filter for US-only companies, the following descriptions would be useful:
    1. Foo - We are building new certificate provider based on crypocurrencies. Python, Scala, JS, Full Time
    2. Bar - Uber for fruit baskets. Node, grunt, JS, workday overlaps New York afternoons (1700 - 2200 UTC)
  13. Any new entry should have meaningful content at the time of the addition to this list — we can't tell whether something is awesome if there is little to see. As a rule of thumb, there should be at least about six months worth of content.
  14. Companies should have "remote DNA".
  15. Link to the career/job page rather than to a single job post.
  16. Job boards should be high quality, without paywalls, requiring login, etc.
  17. No agencies, please.

Dead Link Policy

We check all links are valid with the awesome awesome_bot. If links die, we remove them - this saves time for the maintainers, and ensures awesome links. We'd be happy to accept PRs to re-add new links.