beam-community/elixir-companies

A list of companies currently using Elixir in production.

Elixir Companies

A collection of companies using Elixir in production.

Proudly built with Phoenix.

Adding a new company to the list

• Sign with your GitHub account.
• Click on Add a company button and you will be redirected to a form.
• Fill all required data about the company and submit it.

After that, the admin needs to validate the request.

With everything OK the company will be approved and will appear in companies list.

Adding a new job opportunity for a company

Once your company is available on the list, you are able to add a new Job opportunity for the given company.

• Sign with your GitHub account.
• Click on + Add a Job link and you will be redirected to a form.
• Fill all required data about the company and submit it.

Development

1. Install dependencies with mix deps.get
2. Create and migrate your database with mix ecto.setup
3. Install Node.js dependencies with cd assets && npm install
4. Start Phoenix endpoint with mix phx.server

Now you can visit localhost:4000 from your browser.

Note: You need to set up a GitHub Application and ensure GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET are available to your application. The GitHub application needs its callback set to http://localhost:4000/auth/github/callback and be given read-only access to the email addresses of the user.

Note: You need to have Postgres version 9.5+, due to our use of certain features that are fairly new (JSONB Data Type + ON CONFLICT query).

Note: If for some reason you reset the database on your machine, you will see an error as the browser has cookies for a user that does not exist in the database. You will need to clear the cookies and site data for the page on your browser and refresh the page to remove the error.

Localization

In order to add a new language to the available list of locales, you have to do the following:

• mix gettext.extract in order to extract all the latest gettext msgids from the code
• mix gettext.merge --priv/gettext in order to merge the latest msgids with the locales.
• mix gettext.merge --priv/gettext --locale locale_code in order the generate the files for the new locale.
• Edit the default.po and errors.po in the priv/gettext/{locale_code}/LC_MESSAGES/ dir. You leave the msgids intact and only touch the msgstr fields, where you translate the text accordingly.

elixir-companies's Issues

Github links are giving 404

All (as far as I checked) company github links are returning 404.

Apparently, the company layout is expecting the github field to be a user/org and it's appending to http://github.com/, resulting in a broken url (homepage's first company's github is https://github.com/https://github.com/ScriptDrop?language=elixir).

Add ravio

rav.io

Few lines on how elixir is used

It would be nice to have some info on how elixir is used.

Rethink edit and delete buttons

The buttons are currently too big and take up too much valuable real estate on each card. How can we improve the UX while retaining the functionality?

Edit company has wrong heading at the top

When you edit a company the heading is "New Company", i think we should change it to "Edit Company" or the even the name of the company itself

Company profile enhancements

Following my conversation with @Nitrino it was determined we need to create an issue it identify and implement some profile enhancements to companies. Some of these off the top of my head could include:

• Whether they consider themselves "remote" (despite having offices). I could see people searching on this.
• More complete support for social networks. Right now we store Github and a blog. We could and should allow for others: Twitter, Facebook, Medium, ... you get the idea. Can we find a way to support this without having to add new columns for each new type? I think we can and I think we can update the UI to handle this gracefully.

I'd love to get your thoughts @tajchumber since you do a lot of the UI work 😁

Browse / sort companies by geography / display on map

It would be great to allow folks to sort companies and jobs by their geography (and jobs by remote).

We may want companies and jobs as separate issues.

Add PostGIS to the project

In order to provide the best support for location support and mapping companies/jobs/freelancers, we should encode locations into lat/lon. To properly store this we should look at using PostGIS in this project and adding a point to the company table to store the exact location of the company.

How do we handle companies would multiple locations? Do we even bother supporting that or require a single headquarters? Is a point of nil sufficient for us to determine the company as being truly "remote" and without any office?

Thoughts @tajchumber, @zacck, @gemantzu?

Gettext support

Is it worth us considering implementing Gettext into this project? It will serve as an example for the community in addition to allowing folks to provide translations if they so choose.

Thoughts @tajchumber, @gemantzu, @Nitrino?

Add the country where the company is located

What about adding something like [BR] [US] [PL] in the right side of the name or something like that?

Add Cobenian

Consulting — http://cobenian.com/

Add 404 Page

We need to add a better styled 404 page.
Currently we have a very barebone page that says "Not Found" without any styling (example here)

Company card only has the latest job.

If a company has more than one (approved jobs), they are not all displayed. Only the latest added one is shown.

Add Puppet Labs

http://careers.jobscore.com/jobs2/puppetlabs/sr-software-engineer/a9ONT-te0r5BuJdG1ZS6tF?detail=ElixirConf&remail=&rfirst=&rlast=&sid=161

Allow users to edit existing companies and jobs

There is no way to update a company or a job after it has been posted, we need to provide a means to do this.

Filter/search on location?

It's currently possible to browse by industry, but I think it might also make sense to add location as a filter so folks can see which companies can be found in their country/neighbourhood? What do you folks think, would that be a good feature?

Add ClubConnect

http://nlcollect-bv.workable.com/jobs/7652

All listing

The industry breakdowns are useful but it would be great to just scroll through a comprehensive list as well.

Consolidation and localization of industries

The industry list has been a sore spot for us for a long time, we've had a number of issues on the topic (#337, #252 are just two that come to mind).

With #493 being merged we need to figure out how to complete that work and allow the translation of industries. Before we trouble translators for their time we need to consolidate this list down and identify a way to map a company to the list.

cc @brain-geek @Nitrino @tajchumber @gemantzu

Too many industries

The industries list is so large, some of them don't show on the drop-down. Right now, the list ends for me with "Sports"

It seems there are also some almost duplicates with "Marketing/Sales" and "Marketing/Advertisement/Sales" or "Marketplace" and "Marketplaces".

Fix required Github permissions during authorization

From the authorization process, we only store email and nickname and email on db

so we shouldn't ask for the full access to the profile and public repos but the information strictly neccessary.

Use parentheses around GitHub links

Add seneca systems

seneca.systems

Leaderboard / Gamification

Keeping this list fresh (especially jobs) can be only be automated so much. With the pending_changes table we know who has added, updated, and deleted content. Do we want to explore "incentivizing" folks participation?

@gemantzu / @burden / @shawnonthenet, thoughts?

Identify and set a user's locale for localization

#493 is merged so now we need to devise a way to identify the user's locale and where to handle this. We could use URL paths (/ru/, /en/), rely on a cookie, or browser headers.

What do you think @tajchumber, @gemantzu, @Nitrino, and @brain-geek?

Alert maintainers when a change is submitted

Right now we need to check regularly to see if there are pending changes, we should be alerted when these occur. For now we can stick with a Slack webhook 👍

Test coverage

I'm ashamed of how little testing there is (read: none). This was intended to be quick-and-dirty but now that it's working, we should make it less dirty. The best place to start with that is going to be adding test coverage.

Handle Reject option

Right now, we don't handle the reject option on the admin. We should check on the approved param and either approve the change, or reject it. Also, there is a typo on the accept button name in the form.

Notify user of accepted or rejected changes

We need a way to tell users who've submitted a change that we accepted it or rejected it and why.

Add Bleacher Report

http://bleacherreport.com/

/hiring from google - Route exists but no method in controller

AppSingal shows this:
function CompaniesWeb.CompanyController.hiring/2 is undefined or private
which is possible if you come from google, where we have /hiring as a path (probably some seo left from the old website). This path exists in our router, but internally we have changed this functionality to work through browse?type=hiring.

Adding Digimondo to IoT category

I would like to add my german company Digimondo, which is providing a IoT LoRaWAN Network.

Should i create a new category "Internet of Things" for that?

Prettify the URLs

I think we should use slugs for industries than the raw id field. For instance, I think http://beta.elixir-companies.com/industries/156 should become something like :

• http://beta.elixir-companies.com/customer-service
• http://beta.elixir-companies.com/industies/customer-service

Or maybe we want to ditch the search-by-industry and build a more powerful search page. That could satisfy sorting by industry, #13, and potentially even #14.

• http://beta.elixir-companies.com/companies?industry=customer-service

Thoughts @gemantzu, @shawnonthenet, and others?

Fix the favicon

The favicon appears to be missing, we should fix that.

Twitter handle

I see some occasions where people are using their github field to post their twitter handle.
Should we consider a more robust option (select a "field type" eg twitter - github - etc, give a value, select another "field type", give another option etc)?

Automatically check jobs availability

Right now the project has a problem: most of jobs are outdated. This can be partially solved programmatically.

In case of URL specified is no longer invalid (had 200, now has 404) it's safe to say that vacancy is no longer relevant. We also should check whether site actually has the linked page at the moment of creation.

Would this be a useful feature?

Approvals / authentication urls not showing on mobile

While on mobile, i can't see the approvals and sign in / sign out buttons.

Showing less companies than intended

I have noticed this only on hiring for now, but it is an issue that keeps coming back.

Add Resultados Digitais as a company on the list

I would like to add Resultados Digitais as a company on the list.

Our main stack is Ruby and Go, but we have some projects that are built with Elixir/Phoenix.

Company data:

name: Resultados Digitais
description: We develop a Marketing Automation Platform for S&M companies
url: https://resultadosdigitais.com.br/
github: https://github.com/ResultadosDigitais/
localhost: Florianópolis, Brasil
blog: http://shipit.resultadosdigitais.com.br/
industry_id: Enterprise SaaS

Is that enough? Also, I was not able to find a way to contribute to and add new companies.

Freelancer profiles

We have companies, we have jobs, it makes sense that we also allow freelancers to list themselves and when they're available for hire.

Thoughts on what this should look like @tajchumber, @burden, and @gemantzu?

Test capturing log but not compare the result log

https://github.com/doomspork/elixir-companies/blob/75c10e23bbf4e56896140454e49650c503d1f8bd/test/companies/jobs_test.exs#L26

Using https://hexdocs.pm/ex_unit/ExUnit.CaptureLog.html#capture_log/2 is only for check if has log?

machine-friendly data format?

I'd like to be able to download and/or upload company information in a machine-friendly data format (eg, JSON, TOML, YAML). If this is already possible, please document it. If not, please consider supporting this feature.

Browsing Companies by name should show companies alphabetically

Right now, browsing companies per name does not work properly, the companies with the correct starting letters are displayed but the order they are displayed is not alphabetical.

Consolidating Categories

We have a lot of categories, too many. Should we consolidate the categories into a smaller set with broader categories? If we do, should we add in the concept of tags?

@stevedomin any thoughts?

Hiring ribbon is on top of company name

As you can see, hiring label hides a part of the text for company name. Should we change this or is it as intended?
@doomspork / @tajchumber / @burden thoughts?

Urls when http / https is missing

When http is missing, it converts the url to be a part of the website ("https://elixir-companies.com/url").

Edit: not just the website url, we need to force users to enter the correct protocol for their website, so we do not have to guess which one works.

Localization of company descriptions

This is something brought up during the gettext work. How do we want to handle this if at all? I'm going to defer to @brain-geek and @gemantzu who have years of experience managing and providing translation for Elixir School.

Paging issues

Right now at http://elixir-companies.com/browse page there are 7 companies, 5 on http://elixir-companies.com/browse?page=2 and 8 on http://elixir-companies.com/browse?page=3 and (apparently) further.

It's definitely a bug. But what is the reason why there are 8 companies per page initially? Wouldn't it be better with at least 16, or with endless scrolling?

icon-purle ?

Looking at the HTML for https://elixir-companies.com/en/browse, I noticed a possible typo:

Should this be icon-purple?

Update README

We should update the README with instructions for running the application and seeding data.