Skip to content

Latest commit

 

History

History
30 lines (25 loc) · 2.56 KB

CONTRIBUTING.md

File metadata and controls

30 lines (25 loc) · 2.56 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. Job boards should be high quality, without paywalls, requiring login, etc. At this point, we only accept job boards that are significantly different than the others. Please outline why a job board should be added and why it is different if adding one in a PR. Your PR may be closed without comment if you do not.
  2. Check if the link is working and pointing to the right location.
  3. Check your spelling and grammar.
  4. Choose the appropriate corresponding section.
  5. The list, after your addition, should be sorted alphabetically.
  6. Make an individual pull request for each suggestion.
  7. If you use a text editor to fashion the pull request, make sure your text editor is set to remove trailing whitespace.
  8. New categories, or improvements to the existing categorization, are welcome.
  9. Search previous suggestions before making a new one, as yours may be a duplicate.
  10. Use the following format for the commit message: Add Company Foo.io (without 'awesome' or something else).
  11. Keep descriptions short, sweet and to the point.
  12. Use the following format: [Name](link) - Description. keep the length of the name + description under 100 characters
  13. 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)
  14. 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 general rule, there should be at least about six months worth of content.
  15. Companies in this list should have "remote DNA". This means they are not only remote friendly, but dedicated to remote work as a core of their business.
  16. Link to the career/job page rather than to a single job post.
  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.