oursky / lgbtq-glassdoor

LGBTQ Glassdoor aims to help LGBTQ individuals share and find supportive work environments.

🌈 LGBTQ Glassdoor

https://LGBTQglassdoor.com

The LGBTQ Glassdoor is a side project developed by Oursky, a software development agency with offices in Hong Kong and Taiwan. The LGBTQ Glassdoor aims to help LGBTQ individuals find inclusive workplaces in Hong Kong. The listings on the website are submitted by individuals, LGBTQ-identified and allies, who feel an organization (a company, NGO, or public agency) is LGBTQ-friendly.

The LGBTQ Glassdoor is an opensource directory created with Oursky's opensource backend, Skygear. Anyone who would like to create a similar directory in their city or country can clone the LGBTQ Glassdoor repo. If you do, let us know!

You can also follow us on Facebook and Twitter.

Technology

• Backend: Skygear with Python cloud code
• Frontend: VueJS
• Frontend Template: vue-bootstrap

Folder Structure

The root directory contains a Skygear could functions project, while public_html contains the static HTMLs for deployment.

Entry point for cloud function Cloud code is __init__.py

The Frontend VueJS project is contained under /vue-project.

Run Development

• cd vue-project
• npm install
• npm start

Build for production

• cd vue-project
• npm install
• npm run build

The exported build will be at /dist, which can be deployed using skygear cli.

Pages

• Landing
• Lising of Companies
• Company details
• Add a new company (Disclaimer, Contributor info, Company Info, Confirm page)
• About us page

Table Schema

• Contributor
• Company

CMS

• CMS at Skygear

Localization

• Using vue-localization
• Please update language text under /lang

lgbtq-glassdoor's Issues

[Add Company, Mobile view, Android] Broken layout is found when auto-fill box pop out

(Sync from GitLab issue tracker)

Background:

• Browser: Chrome 68 on Nokia 8 (Android 8.1)
• Reported by: Li Chi Tung

Description:

When keyboard appears, it would push the bottom navigation bar to its top.

Steps to reproduce:

1. Proceed to Step 2 of Add Company using a mobile device
2. Touch the Company Name text field to invoke the auto-fill box
3. Scroll down a little bit
4. The navigation bar would go "through" the auto-fill box

Expected result:

The bar would stay at the bottom when the auto-fill box appears

Screenshot:

[General] Add Automated E-mail Feature

Add E-mail feature for:

• E-mail Capture (for registered users) -- @david90 what are the options for this between quick vs scalable (i.e. SQL database admin access to extract, a google spreadsheet, a Mailchimp list?)
• Trigger automated e-mail for a successful listing creation

[Listing Details] Multiple line comments should be reflected

(Sync from GitLab issue tracker)

Background:

• Browser: Chrome 64.0.3282.137 on android 7.0
• Reported by: Chan Ho Chuen

Description:

During adding company, user can input comment in different lines. Yet, the result will show in the same line.

Steps to reproduce:

1. add company
2. go to comment page and input words in different lines
3. View result

Expected result:

The result words will show in alternative lines

Screenshot:

[All Listings] Fix broken search filters (not displaying).

The search filters in English and Chinese are no longer displaying (occurred bug fix for record saving).

[All Listings] Unable to direct to a correct company with duplicated company name

(Sync from GitLab issue tracker)

Background:

• Browser: Chrome on Windows 10
• Reported by: Cynthia Chan

Description:

Users cannot view the details of a company which has the same name as the other one and is added later than that.

Steps to reproduce:

1. Go to "All Listings" page
2. Select a company which has the same name as the other one and is added later than that

Expected result:

Users are directed to a separate page. / The information of the two companies are combined together.

Screenshot:

[All Listings] No response after clicking browser "back" button

1. Click "Search" / "All Listings" button
2. Click browser back button
3. No response

Expected behaviour: direct user back to home page

[All listings] Filters are gone after clicking detail of company and going back

(Sync from GitLab issue tracker)

Background:

• Browser: Safari on Macbook Air (10.13.4)
• Reported by: Vivian

Description:

Filters are gone after clicking detail of company and going back

Steps to reproduce:

1. Go to "all listings"
2. Add filters
3. Click detail of any company
4. Click "back"
5. Filters gone

Expected result:

Filters remain

Screenshot:

[General] HTTPS

@david90 I think the site still needs HTTPS.

[All Listings, Filter] The clear button is shaded after some items is selected / searching keyword

(Sync from GitLab issue tracker)

Background:

• Browser: Chrome on Windows 10
• Reported by: Kelvin Chan

Description:

After ticking some items / searching keyword in filter, users cannot scroll down to click the clear button

Steps to reproduce:

Case 1

1. At the left side menu, tick some items
2. Scroll down and find that cannot go to click the clear button

Case 2

1. Search some keywords
2. Scroll down and find that cannot go to click the clear button

Expected result:

Can scroll down to click clear

Screenshot:

[Mobile, Layout] Broken layout is found for iPhone SE

• Switching language icon cannot be fully displayed
• Skygear bottom banner cannot be fully displayed
• Cannot scroll down the page to view tag / comment

[All listings] The tag label should be highlighted when user hover over it

User may not know clicking the tag label will direct user to searching for the tag result, as they may think that the whole box will direct them to listing details page

It is suggested to emphasise the label when user hover over it, so that user will know clicking tab label will bring them to search

[Home, Mobile view] Absence of about us button at bottom left corner

(Sync from GitLab issue tracker)

Background:

• Browser: Safari on iPhone 7 (11.4.1)
• Reported by: Vivian

Description:

Absence of about us button at bottom left corner

Steps to reproduce:

1. Scroll to the bottom of homepage
2. absence of about us button

Expected result:

Presence of about us button

Screenshot:

[Add Company] Incomplete Chinese translation on one of the question in Step 2

(Sync from GitLab issue tracker)

Background:

• Browser: Chrome 69 on Windows 10
• Reported by: Li Chi Tung

Description:

"How do you identify?" should not be translated into "您如何"

Steps to reproduce:

1. Add a company
2. Proceed to step 2

Expected result:

"How do you identify?" should be translated into "您如何界定自己?"

Screenshot:

[Search/all listing filter] Cannot display results after choosing two or more options under the same filter

(Sync from GitLab issue tracker)

Background:

• Browser: Safari on Macbook Air (10.13.6)
• Reported by: Vivian

Description:

Each company should only have one company size, but filter allows choosing multiple company sizes

Steps to reproduce:

1. Go go search/all listing
2. choose multiple company sizes as filters
3. Able to choose multiple company sizes

Expected result:

• Unable to choose multiple company sizes, as each company should only fall into one company size category. If allow multiple company sizes selection, companies that fulfil any of the filters should be displayed.
• Similar issue for industry

Screenshot:

[Landing Page] Update Copywriting in top right text

Please update with the copywriting below:

Our goal is to crowdsource a directory of LGBTQ-friendly companies and workspaces for Hong Kong through individual contributions.

We welcome LGBTQ-identified individuals and allies to make anonymous recommendations for companies they would recommend to an LGBTQ person.

(Chinese also needs a translation)

[All Listings, Filter] Misspelling of "Campany"

(Sync from GitLab issue tracker)

Background:

• Browser: Chrome on Windows 10
• Reported by: Kelvin Chan

Description:

The word "campany size" get misspelling

Steps to reproduce:

1. Go to Search
2. Find Campany Size

Expected result:

Should be Company Size

Screenshot:

[Add Company] The comments will duplicate for each submit pressed

(Sync from GitLab issue tracker)

Background:

• Browser: Chrome on Windows 10
• Reported by: Kelvin Chan

Description:

Users can create several comments in one submission

Steps to reproduce:

1. Complete the form
2. At step 3, click submit
3. A pop up will appear, click cancel
4. Submit again, and choose OK in the pop up this time

Expected result:

Comments should not be duplicated

Screenshot:

[Filter by] Spelling mistake of ‘Company’

(Sync from GitLab issue tracker)

Background:

• Browser: Safari on iPhone 6s
• Reported by: Kari Tang

Description:

When clicked on the tap next to ‘Company Size’, the title of the box is ‘Campany Size’

Steps to reproduce:

1. Search
2. Click the ‘+’ sign next to ‘Company Size’
3. ‘Campany Size’ is shown

Expected result:

The title of the box should be ‘Company Size’

Screenshot:

[All Listings] Fix the shown listings after a user has added a new company

Steps to Reproduce

1. Click Add New Listing
2. Fill in individual data
3. Fill in Company data
4. Submit entry
5. Click "see my entry" and there will be missing entries and missing tabs.
6. Click Refresh (the previously missing companies and tags will reappear, but the entry will not be saved).

First tested on Firefox Quantum. Reproduced on Chrome.

[Chinese, All Listings] Change to Chinese tags

[Add Company] Typo on the remainder

(Sync from GitLab issue tracker)

Background:

• Browser: Edge on Windows 10
• Reported by: Cynthia Chan

Description:

There is a typo on the remainder when users add an existing company.

Steps to reproduce:

1. Go to "Add Company" page
2. Follow the instructions until Step 2
3. Click any company existed on the list

Expected result:

The content is free of typos, i.e. "您的提議" and "Your input".

Screenshot:

[Home] Could not scroll down the page and view all tags

(Sync from GitLab issue tracker)

Background:

• Browser: Safari on Macbook Air (10.13.6)
• Reported by: Vivian

Description:

Could not scroll down the page and view all tags

Steps to reproduce:

1. Scroll down the homepage
2. Could not stay at the bottom row, hence could not click on the bottom tags

Expected result:

Could stay at the bottom row after scroll down

Screenshot:

[Chinese, Individual Form] Change MC options to Chinese

Currently the multiple choice answers are still in English.

[Add Company] Update English copywriting & tags

Standardize capitalizations
Check for spelling errors
Remove trans washrooms

[All Listings, Filter, Safari] No response on all the "+" buttons under filter

(Sync from GitLab issue tracker)

Background:

• Browser: Safari on Macbook Pro (10.13.4)
• Reported by: Fung Sze Ching

Description:

It does not make any response upon clicking any button under "by filter" section

Steps to reproduce:

1. Click all listings
2. Click the "+" button next to the items to be filtered

Expected result:

It should pop up an extended menu when "+" is clicked

Screenshot:

[Home] Not all text are displayed in Chinese when language is changed

(Sync from GitLab issue tracker)

Background:

• Browser: Safari on MacBook Air (10.13.6)
• Reported by: Vivian

Description:

Not all text are displayed in Chinese when language is changed to Chinese

Steps to reproduce:

1. Click 繁 in top right hand corner

Expected result:

All text should be displayed in Chinese

Screenshot:

[View details of company, Safari] For long comments, could not view completely when scroll down

(Sync from GitLab issue tracker)

Background:

• Browser: Safari on Macbook Air (10.13.4)
• Reported by: Vivian

Description:

For long comments, could not view completely when scroll down

Steps to reproduce:

1. Go to 'ALL LISTINGS'
2. View the details of a company
3. If the comments section of the company is lengthy, could not view completely when scroll down

Expected result:

View the comment section completely when scroll down

Screenshot:

[Add Company] Add missing LinkedIn Field

Add LinkedIn Field under company website

Text:

Company LinkedIn
公司 LinkedIn

[Add Company] Empty the auto-complete field still remain the options

(Sync from GitLab issue tracker)

Background:

• Browser: Chrome on Windows 10
• Reported by: Kenny Ng

Description:

In step 2 when adding a company, after entering some keywords, the result will still remain when you empty the field

Steps to reproduce:

1. Add Company
2. Go to step 2
3. Click the Company Name field
4. Enter some keywords
5. Empty the field

Expected result:

The options should be reset after empty the field

Screenshot:

[Add company] Some fields with asterisk can keep empty

(Sync from GitLab issue tracker)

Background:

• Browser: Chrome on Windows 10
• Reported by: Kelvin Chan

Description:

For some field with *, users can keep them empty and submit successfully

Steps to reproduce:

1. Add company
2. For the typing field with *, input information
3. For the ticking field with *, keep them empty
4. Submit

Expected result:

Error message should be shown if users keep any fields with * empty

Screenshot:

[Home/About us, Mobile view] The black box at the bottom blocks words from being shown

(Sync from GitLab issue tracker)

Background:

• Browser: Safari on iPhone 6s
• Reported by: Kari Tang

Description:

The black box blocks words from being shown.
When users scroll down and hold, there are words. But when they release the finger, the webpage scrolls back up and the back box blocks the words.

Steps to reproduce:

1. Enter any page in the website
2. Scroll to the bottom
3. The black box blocks whatever underneath

Expected result:

The things underneath the box should be visible instead of being blocked.

Screenshot:

^ Scroll down and hold

^ Release finger. The black box blocks an entire section

[Search/All listings] No response when clicking the tags

(Sync from GitLab issue tracker)

Background:

• Browser: Safari on Macbook Air (10.13.6)
• Reported by: Vivian

Description:

No response when clicking the tags

Steps to reproduce:

1. Go to Search/All listings
2. No response when clicking the tags

Expected result:

Should be able to add filters when clicking on the tags

Screenshot:

[All Listings] Should not display URL with the word "null"

(Sync from GitLab issue tracker)

Background:

• Browser: Safari on iPhone 5s (11.4.1)
• Reported by: Fung Sze Ching

Description:

When you search keywords using the search box, it does not direct user to the search result. Instead, user has to scroll down by himself to see the results. It looks like that the search function does not work as the user does not know the search result is out until he scrolls down manually.

Steps to reproduce:

1. input search key words
2. press browser back button
3. see that the URL is displayed with the word "null"

Expected result:

It should direct users to the results automatically

Screenshot:

[Mobile, Add Company, iOS] No response for submit button

(Sync from GitLab issue tracker)

Background:

• Browser: Safari on iPhone 5s (11.4.1)
• Reported by: Fung Sze Ching

Description:

When you add a company, at the final step, the submit button does not work so I pressed 3 times. Indeed, the same company is added three times but the submit button simply does not direct user to the next page. In the video, I keep clicking submit but there is no response, so I press "prev" and try again. The photo shows 3 identical companies added

Steps to reproduce:

1. Add a company and proceed to the final step
2. click "submit" button N times (N is any number)
3. click the "LGBTQGLASSDOOR" logo to direct to home page
4. search the company you just added
5. Search result shows N same companies added

Expected result:

It should direct user to the next page so that user knows the company is added successfully and prevent user from adding the same company many times

Screenshot:

[Add Company] Get confused for the field "Company" in Step 1 & 2

(Sync from GitLab issue tracker)

Background:window 10

• Browser: Google Chrome( 67.0.3396.99)
• Reported by:Yan Hei Cheuk

Description:

User may know clearly understand the different between two Company fields

Steps to reproduce:

1. add company
2. enter a name on the company blank
3. enter another name on company blank

Expected result:

Better indicate the field

Screenshot:

[All Listings, Filter] Single character tags are displayed after clicking clear button

(Sync from GitLab issue tracker)

Background:

• Browser: Chrome on Windows 10
• Reported by: Kelvin Chan

Description:

The filter of the category "Community" makes filter for each character after clicking clear for several time

Steps to reproduce:

1. Click search
2. At the left side menu, Choose some items in "Community"
3. Click the clear button
4. Tick a item in "Community" again

Expected result:

The items should not make one box for each character

Screenshot:

[All Listings] Same tag is appeared

(Sync from GitLab issue tracker)

Background:

• Browser: Chrome on Windows 10
• Reported by: Kelvin Chan

Description:

Same tag "Allies" appear

Steps to reproduce:

1. Add company
2. Tick "Strong and vocal allies" and "There are allies to turn to for help or raise issues with."
3. Complete the addition

Expected result:

More description to show the difference of the 2 tags

Screenshot:

[All Listings] Misspelling of "mataching"

(Sync from GitLab issue tracker)

Background:

• Browser: Edge on win10
• Reported by: Chan Ho Chuen

Description:

Spelling mistake for "matching"

Steps to reproduce:

1. All listing
2. randomly select filter or input keyword to access the no matching page
3. Sentence "No mataching entries... yet" appears

Expected result:

should be "matching"

Screenshot:

[Search] Cannot filter company by clicking tags after viewing any company details

(Sync from GitLab issue tracker)

Background:

• Browser: Chrome on Windows 10
• Reported by: Kenny Ng

Description:

Users cannot filter company by clicking the tags in the searching page after entering any company detail page by clicking the company card.

Steps to reproduce:

1. Go to search page
2. Click any company card to view the company detail
3. Click 'Back'
4. Click on any tags under any company card

Expected result:

Should be able to filter the company by tags after direct back from the company detail page.

Screenshot:

Click on any company card:

Inside detail page, click 'Back':

Click on any tag under any company card, and no response:

[Add Company] Add missing website field

Please add a field for someone to fill in their company website (Optional)

English:
Company Website:

Chinese:
公司網頁：

--- The URL should display on the company card in the "All Listings" page as an outbound link ---

[Listings/Searching] The tags colors are not consistent

(Sync from GitLab issue tracker)

Background:

• Browser: Chrome on Windows 10
• Reported by: Kenny Ng

Description:

The tags colors on homepage and searching/listing page are not consistent

Steps to reproduce:

1. Go to homepage to view the tags colors
2. Go to search page to view the tags colors again

Expected result:

Should be consistent

Screenshot:

[Mobile, Home] Misalignment of functional buttons

(Sync from GitLab issue tracker)

Background:

• Browser: Chrome on Sony Xperia XZ (8.0)
• Reported by: Cynthia Chan

Description:

The three buttons are not aligned tidily.

Steps to reproduce:

1. Go to "Home" page

Expected result:

The buttons should be ordered either to the same line or in centre.

Screenshot:

[Disclaimer] A few lines in disclaimer is hidden after filtering

(Sync from GitLab issue tracker)

Background:

• Browser: Chrome on Windows 10
• Reported by: Kenny Ng

Description:

Cannot show the disclaimer completely after filtering something. But if you move the mouse inside the disclaimer, we can still view it completely.

Steps to reproduce:

1. Go to search page
2. Filter company by selecting in 'Filter By' (Filter to "No results")
3. Scroll down (cannot view the disclaimer)
4. Move the mouse inside the disclaimer
5. View the disclaimer again

Expected result:

Should show the disclaimer completely after filtering

Screenshot:

After filtering:

After pointing to it by mouse:

[All Listings] Should include validation checking for Company Website & Linkedin

User can input invalid value in Company Website & Linkedin fields and they will be directed to page shown 404 not found

[All listings] Users will be directed to the detail page if clicking "Website" / "Linkedin" / tags

(Sync from GitLab issue tracker)

Background:

• Browser: Chrome on Windows 10
• Reported by: Kelvin Chan

Description:

Users will be directed to the detail page of the company if they click the "Company Website" of that company

Steps to reproduce:

1. All listings
2. Find a company and click the "Company Website"
3. Find that the LGBTQ page go to the detail page of that company

Expected result:

The page should not go to the detail page

Screenshot:

[About us] Cannot view the content under "Follow us on Social Media"

(Sync from GitLab issue tracker)

Background:

• Browser: Chrome on Windows 10
• Reported by: Kelvin Chan

Description:

Cannot view the content under "Follow us on Social Media" (Can view after refresh the page)

Steps to reproduce:

1. Go to main page
2. Click About us
3. Scroll down

Expected result:

Should be about to view the content

Screenshot:

[Add company] There are no checking whether the email address contain domain

(Sync from GitLab issue tracker)

Background:

• Browser: Chrome on Windows 10
• Reported by: Kelvin Chan

Description:

When input the information, users can type the email address without domain

Steps to reproduce:

1. Add company
2. For the email address, type something like aaa@aaa

Expected result:

A error message should appear to warn that no domain is typed in email

Screenshot:

[All Listings] Add Static Disclaimer Text Box Under Filter Area

Please add a text box with the copywriting below (black text is fine, not red).

Disclaimer: LGBTQ Glassdoor strives to be a transparent place for LGBTQ-identified individuals to search for inclusive workplaces in Hong Kong. The user-submitted information displayed reflects the views of the individual contributor and not necessarily the contributor’s employer or organization.

[Chinese, Company Form] Change MC options to Chinese

[Add Company] Autofill names (to avoid double entries)

Expected Behaviour for this feature

• User filling out the form: When I type in my company, I will see the company pop up if it is already in the database. This means that the check boxes that I check off will be added to the existing company listing.

• If I submit an additional text review, my review will be added as a card to the company listing.

• Public User browsing the directory: If I go to the All Listings Page, I see the *combined (not duplicated) tags *of all the people who have submitted in the card for Company A.

• If I click into the card for Company A, I see the combined tags that have been checked between all previous users, and I see individual cards for annonymous review.

• As an Admin:*I should be able to use the Skygear CMS to manually add / delete tags in listings. (For example, if a company contacts us and says we have an incomplete set of tags, we need to be able to add them).