The website from taiwangoldcard

community page amp error: The tag 'img' should be replaced with an equivalent 'amp-img' tag.

Lighter weight version of jQuery

jQuery is heavy. There are lighter versions these days.

https://kenwheeler.github.io/cash/

Did a quick check, seems like scrollTop function needs replacing. Can probably check out https://bestofjs.org/projects/you-dont-need-jquery

Integrate the chatbot?

Jonathan's article on how we built the chatbot got a lot of visits on a lot of people interacted with the bot asking questions about life in Taiwan

We can easily use our FB integration add it easily in the website with low effort. It also shouldn't be intrusive, and add value to people asking specific questions the website can't reply. Here some conversations we got :

Site Search is Disabled, and when Enabled it only sends users to broad sections

The site search, powered by lunr.js is currently disabled in config.toml.

This is a necessary feature and should be fixed.

At the moment, when enabled, search is functional. However, the search results it provides only include major section titles and link through to major sections.

Instead, search results should include individual question headings and link through to individual questions.

Change content order in homepage

As discussed in #13 (comment), we should probably change the order of content in the homepage.

First line : Applying the GC / Beeing a GC holders
Second line: And then news and the photo.

(Also the photo doesn't add much, and we should probably think of a better one later)

Disclaimer to protect contributors

Should we have a clear disclaimer protecting contributors? I'm not a lawyer, and that might sound overkilled, but we start getting more traffic day after day, and visitors applying for the GC will probably follow our answers.

I'm thinking we can add :

A simple , short, and clear disclaimer at the footer of the page , or the end of the FAQs pages
A clear TOS page that protects us legally

Suggestion: New page for useful links

Like the awesome list of links

e.g. I often cannot find the government website link to check for my application

Suggestion: List of private firms and/or individuals that can advise a gold card applicant

I'm considering applying for a gold card, but am unsure about if I qualify, what category I should apply under, and what supporting documents I sould include in my application.

I'm reaching out to the government agencies listed on the site, but they are slow to respond, and not always super helpful.

It might be nice to include links to private firms, like immigration lawyers, that can be contacted for paid advice and assistance regarding a gold card application.

Thanks so much for the site, it's an awesome resource!

Improve SEO based on Moz SEO report

Attached the SEO analysis report from moz, hopefully this gives good ideas on how we can improve the visibility of the site. If we can get some top media sites (high page rank) to give us a backlink, I think this will bump as up.

Keep users in the same tab when clicking on external links

For web usability and UX perspective, and add with accessibility for all users (mobile especially)

To implement this, it could be find where the _blank tag is added in the href.

Layout idea: better distinguish FAQ entries

Currently FAQ entries are simply a set of heading and text on a page.

It might be a good idea to explore ways to define the boundaries of a given question/answer pair in the layout for better readability.

For example, look to forums such as reddit where every post is surrounded by a border box. Or, look to sites where there is subtle alternate shading between entries in a long list of posts.

[Directory] Start adding person in directory (readonly)

Purpose

The directory starts becoming really valuable and we reach 15 persons who want to connect with each others. It is not shared to anyone yet, but I'd like to start adding people who agreed to appear in the directory. We won't announce it in the group yet, but I guess it's the next natural next step.

What will be visible:

FIrst name
1st letter of Last name
Intro
What they are looking for

Email or line-id won't be shared, people will connect via Lina if they want. The directory is on readonly mode. All the people in that directory agree to appear in the Gold Card Directory

I'd like approval/concern before proceeding 🙏

Add contributor guide

Many git repos have a dedicated CONTRIBUTING.md file that explain how to contribute in a bit more depth. Creating one of those is a good way to capture some of our 'tribal knowledge' about how we work together, making it easier for new people to jump in and feel confident they are doing the 'right' thing. To cover areas such as:

Who can get push rights, and who to contact to get them (at the moment, all comers should say hi and are given push rights)
How we communicate outside of github (ie our LINE group)
Encourage new contributors to add their name to about.md
When it's OK to merge a patch straight into master (deployment, typo fixes, non-contentious content updates, straightforward layout updates) and when we like to use an issue or pull request to review (updating/adding FAQ entries which could be contentious or it's difficult to say for sure we're correct, big layout changes)
Our collaboration 'principles'
how to find something to work on

amp issue on /terms and /about

Error from Google Search console:

The tag 'img' should be replaced with an equivalent 'amp-img' tag.

https://taiwangoldcard.com/amp/terms/

https://taiwangoldcard.com/amp/about/

Dynamically display "Gold Card News" section with limits

Proposal
According to Gold Card News section's nature, its content is expected to be added incrementally. The major problem of the current section is that it will be overflown with an increasing number of news added in the future. Therefore, it would ideal if the content is rendered dynamically based on some configurations.

Screenshot of potential problem

Possible solutions

Create a JS script to limit its content
All news can be viewed in a separate page

Using Netlify instead of Github Pages

Advantages:

Simplify deployment. No more docs/ folder in version control. Just push new code to repo, and a github webhook will hit netlify to pull the source code for deployment.
Potentially better savings on page speed
Access to Netlify CDN & Netlify CMS
Free, with SSL too.

Disadvantages:

More lock in to a vendor
Netlify CI can only build static site. So if we want to do more stuff like running tests, those will still go into github workflow.

Some references:

https://www.employbl.com/blog/rebuilding-personal-site-netlify-and-hugo

Release bot goes into infinite loop

Context:

We want branch protection
We want to configure secrets on this repo, but secrets should not be shared to forks
Github workflows should still work even if PRs are opened from forks

Ref #143, this change was commited in an attempt to make the bot release changes made from PR forks.

The secrets configured on this repo correctly propagate to the bot, however the bot goes into a release loop:

If we use:

on:
  pull_request:
    branches:
      - master
    types: [closed]

the loop will be gone but the bot only gets the secrets if the PR is NOT opened from a fork. Looking for suggestions to fix this without removing branch protection.

Community contributors in the /community page

We should highlight the work done that make our community better in the https://taiwangoldcard.com/community page.

It can look like:
Name: contribution that was made

@hasnouille: event organised
Philip : initiate monthly event
Quentin: event organised

etc...

Do you think we can somehow put the community page in Netlify @geekyme ?

Discussed in #149

What financing solutions are available for Gold Card Holders?

Would be great to add content / links on different ways to finance projects, for people who'd like to contribute to Taiwan 🇹🇼

Fundraising is a first, but might be accessible for people doing a tech project only
Loan is an other, but you might need a Taiwanese guarantor ?

Loan:
For the Culture & Art folks, there is new initiative to make access to loans easier (up to 2million NTD) , for who want to start a venture in Taiwan (example sgiven: open a bookstore, craft creation, fashion design, anime, music, art exhibitions, performing arts groups, table tours, illustrations, magazines, curriculum, galleries, open articles, image authorization, youtuber , recording podcast, video studio etc...

FB link: https://www.facebook.com/306276709452272/posts/3311603148919598/
With more details: https://taicca.tw/article/b861494e

Fundraising:
?

Broken link: NHI Local office list

The link to the NHI offices is broken (404):
https://taiwangoldcard.com/goldcard-holders-faq/health-insurance/

But it seems even the link from nhi.gov.tw is also broken, so I'm not sure we can do anything about it at the moment:
https://www.nhi.gov.tw/English/Content_List.aspx?n=20A93E4CE83C5762&topn=ED4A30E51A609E49

Feature Request: Method to edit content for non-techical contributors

We have the potential (and need) to significantly expand he number of contributors to the content portion of our website.

The current editing process works well for those with knowledge of git, the command line and markdown syntax. However, it also means that 100% of our contributors come from a technical background.

We need a way that people who have excellent writing skills but no technical ability can just jump in and propose changes. This should be something they can run through their browser.

The implemented feature should ensure that the edits proposed by new editors is subject to approval before publication, and that all edits are tracked in version control and attributed to individuals.

Rename "wizard" to something less technical

Thought about the "wizard" name: I like how they called it "visa quick check" .

By being non-english native speaker , I didn't know what means " wizard ", even after working 5+ years for an american tech company... is it common to use that word? Shouldn't we make it easy to understand for any non native english speakers?

@fifieldt suggests "Gold Card Qualification Check" , I like it too

please approve/disapprove 🙏

Missing Content

There are several areas of content that I've come across that might warrant additions, here's a hitlist:

Idea: Find somewhere to store English translations of the common Chinese error messages during application

There are a range of common messages in the application portal that are not translated into English. Perhaps we can add a page where these are provided?

申請人以免籤證入境，申請時身份類別選擇錯誤，不予許可　-> You entered Taiwan 'visa-exempt', but when applying you selected the wrong visa/identity category, application refused.
待二審 -> Undergoing secondary inspection

dateTime and homePicture can be presented more appropriately

DateTime on 'Gold Card News' displays inappropriately. As can be seen from the section, Datetime's style should be displayed in the same line for better readability

${EEA534E3-BB23-4DF8-B78D-430F02C10BCD}_20200716090947$

homePicture is too big and not adjusted. Margin and padding can be applied here.

"Do I Qualify" link in header nav should point to FAQ onsite vs. external page

The first "Do I Qualify?" button on the header top nav takes user to a poorly formatted Visafinder external site. Suggest this button first points to the "Do I Qualify" section of FAQ instead to keep user onsite for context before taking them to external site.

More emphasis on the Gold Card Qualifications Quick Check

A thought I had many times after seeing a lot of praises on the "Gold Card qualification checker" and how helpful it is to pick the correct category. Remembered @audreyt didn't find it easily either when navigating the website

We should perhaps think on a better place to put it? It's now "hidden" in the text, I think it deserve a better place.

Few ideas:

in the homepage?
On the top menu?

Some thoughts @alvinsj @iansinnott ?

Auto-deploy when we merge in master

Something I've noticed is that we often forget to deploy after we merge a Pull Request. So changes aren't visible on the website until the following one do deploy.

This can be done with github actions

Definitely low priority

Investigate multi-language capabilities

Not everyone wanting to apply for the Gold Card can handle large blocks of English text. If we were to get a sufficient number of contributors who could write in a language other than English, it might be worth having the site available in other languages.

This is probably some time in the future, but in the meantime, perhaps we shouldn't do anything that would explicitly prevent a multi-language version of the site coming into existence :)

It looks like in hugo it's surprisingly straightforward.

For the content - just needs to be the same filename with a language tag and a bit of config
https://gohugo.io/content-management/multilingual/
https://regisphilibert.com/blog/2018/08/hugo-multilingual-part-1-managing-content-translation/

then there's a Language.lang element in the .Sites page property that can be use as a switch in templates for logic and an i18n shortcode that can use po files for template wording.

Add official links for the consequences of not updating address

Discussed on #36

Ideally, we would have official links for the consequences of not updating the residential address within 30 days after moving in.

Make footer and category intro text consistent with disclaimer

#50 introduced a site-wide disclaimer/terms.

We currently also include other disclaimer-like content in several areas:

site footer
introduction text for each major category
callout notes embedded in the text

We can't include the full terms in each of these locations, but need to reference the disclaimer somehow. The places we use disclaimer-like content should be updated to ensure they are consistent with the disclaimer and linked to it.

Same typo in 3 places: "enrol" should be "enroll"

https://github.com/taiwangoldcard/website/blob/master/content/goldcard-holders-faq/health-insurance.md#how-do-i-enrol-into-the-program

https://taiwangoldcard.com/goldcard-holders-faq/health-insurance/#is-nhi-mandatory

License?

@fifieldt suggested those licenses, I don't see any issue with that and I think it works well since anyone from the gold card community can contribute in the documentation.

Documentation contributions will be licensed under the CC-BY-SA-NC license.
Code contributions will be licensed under the Apache 2.0 License

Anyone has any objections? just a thumb-up to agree :)

APRC revoked after a long leave: 183days or 5years?

Not directly linked to the Gold Card itself , but it can be a reason for people to get the gold card. The promise of keeping a permanent residency by just showing up once every 5 years is , IMO, a big positive argument.

I've also heard a lot of wrong information about the conditions to keep the APRC when outside Taiwan. People confuse :

APRC obtained with a marriage: you lose it after 183 days out of Taiwan.
APRC obtained after a "work" ("foreign professional") ARC: you lost it after 5 years out of taiwan.

My question now is: Are we eligible for the "foreign professional" APRC after getting the gold card, no matter employed or "unemployed"?

Article 18 of the Act for the Recruitment and Employment of Foreign Professionals :

Is adding that information relevant @fifieldt @cbrolly @pqvst @iansinnott ?

News item: Gold Card now cheaper

@cbrolly found a link to a update of the pricing regulations for the gold card. According to @jliao-tw Z's analysis, it's now cheaper to apply than before.

This seems worthy of a news item.

Mobile: Cumulative Layout Shift (CLS) >0.1

Cumulative Layout Shift (https://web.dev/cls/ ), which defines how much the bits on the page 'move around' while loading is 0.19, which exceeds the Google recommendations for mobile.

Redesign of Application content

We should re-work the Application content so that it is aligned with the process that people applying go through. This will let applicants go directly to the most relevant content for them.

This will be a bit of a change from our current FAQ style - written in more 'instructional' language - and will probably mean some layout changes to make it possible.

Here are the steps of the application process:

Understanding what the Gold Card is
Determining how to qualify
Creating an account, logging in and starting a new application
Identity and Visa details, terms and conditions
Basic Data
Passport Data
Visa Application
Resident
Profession
Upload Document
Submit Application->Under Review-> 待二審
Professional Review by Workforce Development Agency->Supplementary Document Submission
Passport Submission by Bureau of Consular Affairs or Overseas Missions of R.O.C.
Under Inspection->Application Approved->IC Card in Process->Collect card

Recent Contributors not listed on the about page

Our About page lists contributors to the site: https://taiwangoldcard.com/about/

It's currently missing some people who have made recent contributions, including:

Recommendations on services to use?

Would that make sense to give recommendations on which service to use? I now maintain a spreadsheet I send from time to time in the Line group , but wondering if that'd make sense to put it in the website?

The downside is is that we would start becoming a bit opinionated . Maybe we can balance this with few options for each "service"

For example the question that often come is about banking where we can cover:

English friendly opening account / support
English UI / App
credit cards / debit cards
corporate / personal
wire fees
calls when incoming wire from abroad
International phone numbers for 2 Factor Authentication (SMS)

On mobile, after the chatbot loads, scrolling doesn't work

On Chrome on Android,

Open a link like https://taiwangoldcard.com/goldcard-holders-faq/health-insurance/
Quickly, before the bot loads, try and scroll the page
After the bot loads, try and scroll the page

What should happen:
during steps 2&3, the same scrolling behaviour should be experienced

What happens instead:
During step 2, scrolling works
During step 3, scrolling does not work.

Lighter profile images on community profiles photos

The community page https://taiwangoldcard.com/community/ page has profile images that are too heave. 1MB each!

it shouldn't be that heavy, ideally ~200kb at most or lighter

Menu on Application FAQ "flashes" on load

As reported by @jliao-tw , when a user first clicks on the "Application Process" button or the "Gold Card Application FAQ" menu header, the enter side menu with all subheadings appears briefly before disappearing.

This is unnerving for the user and makes making videos demonstrating the site difficult, since it is very visible in those. Interestingly, it does not happen when the "Life in Taiwan" menu is clicked.

What it looks like is happening is that when the page is loaded all of the headings are 'there', and then some javascript comes in quickly to 'hide' them. It's probably done with the aim of having faster load times when moving between sections since all of the headings are pre-loaded and good to go, just hidden. However, a) it sucks for creating videos and b) interestingly, it doesn't happen for the "Life in Taiwan" section, so I would think it is a bug. The potential way to fix this is to start with the minimal set of headings, and then run the javascript to add in everything but in the hidden way. Same result, but the user will never see it happen 🙂

Qualification Wizard Enhancements

A master issue to collect enhancement requests for the Gold Card Qualification Wizard

Improve wording of "HQ of a multinational
Add Gold Card Holder Profiles (#10 ) to results page to give examples for each category
Provide document requirements on results page

Question: How do you apply for NHI without an employer

The FAQ mentions that your employer will apply for NHI for you. However, we don't mention anything about how to apply for NHI yourself if you don't have an employer (i.e. after the six-month waiting period). I personally don't know the answer to this, but I'd be glad to sort this out if anyone can explain or link to the process.

Faster pages on mobile (amp / fip)

On Facebook, there's Facebook Instant Pages (fip). On Google, there's Accelerated Mobile Pages (amp). These formats could load up to 4X faster on mobile.

Perhaps we can exploit Hugo's custom output formats? https://gohugo.io/templates/output-formats/

Amp pages also ranks better on google.

Feature Request: Gold Card Holder Profiles

We would like to show off our community, and give them a chance to express themselves.

Create new functionality that accepts content for "profiles" of gold card holders - including an image and some text, that can be displayed on the site. Profiles could be displayed in a carousel on the main page, and also available as a list (eg in the style of "case study" lists on corporate websites).

Code formatting

As we get more contributions to this repo, I think its best to have automated code formatting. Prettier is a good option.

See this link for tips on how to configure it with go templates (the syntax that hugo use) https://discourse.gohugo.io/t/hugo-and-prettier/22596

Using system fonts instead of custom web fonts?

https://www.wholegraindigital.com/blog/performant-web-fonts/

Web fonts currently slow down our page rendering.

Maybe we can just use this stack, it works on every platform, no need for custom web fonts.

body {
  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI",
               Roboto, Oxygen-Sans, Ubuntu, Cantarell,
               "Helvetica Neue", sans-serif;
}

Gold womxn

I finally get to starting a discussion, perhaps a page for [womxn](https://en.wikipedia.org/wiki/Womxn#:~:text=The%20term%20Womxn%20(%2F%CB%88w,nonbinary%2C%20and%20women%20of%20color.).

This is a place holder, in my brain and a space creation for anyone who has ideas, thoughts on the content/knowledge that needs producing for this section.

I would like to mention this on the GC Line group, after the launch of the featured profiles with interviews. Let me know what you think.

About page doesn't list all contributors

The About page currently only mentions Eric and Tom.

This should be expanded to ensure all contributors get a mention :)

taiwangoldcard / website Goto Github PK

website's People

Contributors

Stargazers

Watchers

Forkers

website's Issues

Purpose

What will be visible:

Recommend Projects

Recommend Topics

Recommend Org