Skip to content

docs: update supported versions for browsers #21606

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed

Conversation

jbogarthyde
Copy link
Contributor

PR Checklist

Please check if your PR fulfills the following requirements:

PR Type

What kind of change does this PR introduce?

[ ] Bugfix
[ ] Feature
[ ] Code style update (formatting, local variables)
[ ] Refactoring (no functional changes, no api changes)
[ ] Build related changes
[ ] CI related changes
[x] Documentation content changes
[ ] angular.io application / infrastructure changes
[ ] Other... Please describe:

What is the current behavior?

browser support versions need update

Issue Number: #19618

What is the new behavior?

Update to latest browser support, in more general terms - "latest 2 major versions"

Does this PR introduce a breaking change?

[ ] Yes
[x] No

Other information

This phrasing requires less maintenance.

@mary-poppins
Copy link

You can preview e125c62 at https://pr21606-e125c62.ngbuilds.io/.

@@ -52,19 +52,19 @@ Angular supports most recent browsers. This includes the following specific vers
</td>

<td>
14
latest 2 major versions
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should the number be two or 2?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the shorter form is better in a table

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I agree. You're right.

Copy link
Contributor

@dennispbrown dennispbrown left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review summary for sample comments. This is a test.

@@ -88,19 +88,19 @@ Angular supports most recent browsers. This includes the following specific vers
</td>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great table.

Copy link
Contributor Author

@jbogarthyde jbogarthyde Jan 17, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks. no action needed.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should Nougat and Marshmallow be separate rows? I see they are the same row in the current released doc, but I notice that all over supported versions are each given their own row.

</td>

<td>
11
</td>

<td>
10
latest 2 major versions
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we change latest to last?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OK

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done

@mary-poppins
Copy link

You can preview 92a5616 at https://pr21606-92a5616.ngbuilds.io/.

@jbogarthyde
Copy link
Contributor Author

@dennispbrown All comments addressed. Ready for peer review.
@jenniferfell Ready for doc review

Copy link
Contributor

@dennispbrown dennispbrown left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All looks great.

@googlebot
Copy link

So there's good news and bad news.

👍 The good news is that everyone that needs to sign a CLA (the pull request submitter and all commit authors) have done so. Everything is all good there.

😕 The bad news is that it appears that one or more commits were authored by someone other than the pull request submitter. We need to confirm that all authors are ok with their commits being contributed to this project. Please have them confirm that here in the pull request.

Note to project maintainer: This is a terminal state, meaning the cla/google commit status will not change from this State. It's up to you to confirm consent of the commit author(s) and merge this pull request when appropriate.

@mary-poppins
Copy link

You can preview 23efa05 at https://pr21606-23efa05.ngbuilds.io/.

@mary-poppins
Copy link

You can preview 85c3093 at https://pr21606-85c3093.ngbuilds.io/.

@jbogarthyde
Copy link
Contributor Author

@dennispbrown agreed to latest change
@jenniferfell ready for approval

@jenniferfell jenniferfell added the target: patch This PR is targeted for the next patch release label Jan 19, 2018
@jenniferfell jenniferfell self-requested a review January 22, 2018 21:08
@jenniferfell
Copy link
Contributor

@jbogarthyde : Please resolve issue with most recent commit message.

INVALID COMMIT MSG: "docs:minor edit"
=> ERROR: The commit message does not match the format of "(): OR revert: type(): "
Please fix the failing commit messages before continuing...
Commit message guidelines: https://github.com/angular/angular/blob/master/CONTRIBUTING.md#-commit-message-guidelines

@dennispbrown recently learned how to essentially re-do a commit with a new message, so I think he can help or point you to the right recording. Thanks!

@jbogarthyde jbogarthyde force-pushed the jb-fix-browser-support branch 2 times, most recently from 71d9a44 to bb9221b Compare January 23, 2018 18:11
@mary-poppins
Copy link

You can preview bb9221b at https://pr21606-bb9221b.ngbuilds.io/.

Copy link
Contributor

@jenniferfell jenniferfell left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@jenniferfell
Copy link
Contributor

@IgorMinar Work is completed on this PR. I've reviewed and approved. When you get a chance, please review...approve...and mark for merge. Or let us know if there's anything else you want changed (@jbogarthyde) or process-stuff (me). Thanks!

@jenniferfell jenniferfell added the action: review The PR is still awaiting reviews from at least one requested reviewer label Jan 25, 2018
Copy link
Contributor

@IgorMinar IgorMinar left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this one needs a bit more work


But if you need an optional polyfill, you'll have to install its npm package with `npm` or `yarn`.
For example, [if you need the web animations polyfill](http://caniuse.com/#feat=web-animation),
you could install it with either of the following commands:
For example, [if you need the web animations polyfill](http://caniuse.com/#feat=web-animation), you could install it with either of the following commands:

<code-example language="sh" class="code-shell">
npm install --save web-animations-js
yarn add web-animations-js
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this line is wrong. (it was already wrong before). it should be one or there other command depending on if the user is using npm or yarn to manage dependencies. but not both.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jbogarthyde can you please fix this in this PR? thanks

@@ -350,34 +302,28 @@ Here are the features which may require additional polyfills:
<tr style="vertical-align: top">

<td>

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think all these spaces were required because if you are mixing markdown and html there needs to be a blank line between the two contexts. Because of this none of the links in this table were turned into clickable links. See: https://pr21606-bb9221b.ngbuilds.io/guide/browser-support#optional-browser-features-to-polyfill

@IgorMinar IgorMinar added action: cleanup The PR is in need of cleanup, either due to needing a rebase or in response to comments from reviews and removed action: review The PR is still awaiting reviews from at least one requested reviewer labels Jan 26, 2018
@jbogarthyde
Copy link
Contributor Author

jbogarthyde commented Feb 1, 2018

Corrected commit comment - lacking space after "docs:"
Still seems to be failing test, however.

[Typed&nbsp;Array](guide/browser-support#typedarray)<br>
[Typed&nbsp;Array](guide/browser-support#typedarray)

<br>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this br should not be here. I don't think you mean to have a blank line in between the items:

screen shot 2018-02-01 at 2 56 24 pm

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done


<code-example language="sh" class="code-shell">
npm install --save web-animations-js
</code-example>

<code-example language="sh" class="code-shell">
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've looked at the rendered output and I think it looks confusing to list both commands like this. our readers either don't know about yarn in which case they will copy & paste the code for npm install. If they are familiar with yarn, they'll know by heart how to convert the npm command to yarn.

Therefore I suggest you remove the yarn version completely and leave only the npm version. thanks!

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done

@jenniferfell
Copy link
Contributor

@IgorMinar @gkalpak I looked into CircleCI lint failure and found the message below. We thought scope
was optional, but looks like we need it? Is this what's causing the failure? Otherwise, I think this is ready to mark for merge. Thanks!

Examining 3 commits between HEAD and master
INVALID COMMIT MSG: "docs:clarify npm/yarn commands, add blank lines to mix md/html in table"
=> ERROR: The commit message does not match the format of '(): ' OR 'Revert: "type(): "'

@mary-poppins
Copy link

You can preview 8310f7f at https://pr21606-8310f7f.ngbuilds.io/.

@IgorMinar IgorMinar added action: merge The PR is ready for merge by the caretaker and removed action: cleanup The PR is in need of cleanup, either due to needing a rebase or in response to comments from reviews labels Feb 2, 2018
@ngbot
Copy link

ngbot bot commented Feb 2, 2018

I see that you just added the PR action: merge label, but the following checks are still failing:
    failure status "ci/circleci: lint" is failing

If you want your PR to be merged, it has to pass all the CI checks.

If you can't get the PR to a green state due to flakes or broken master, please try rebasing to master and/or restarting the CI job. If that fails and you believe that the issue is not due to your change, please contact the caretaker and ask for help.

@IgorMinar
Copy link
Contributor

One of the commit messages is still invalid. There is a space missing after a colon. Can you please fix?

@jbogarthyde jbogarthyde force-pushed the jb-fix-browser-support branch from 8310f7f to 6f10db0 Compare February 2, 2018 17:12
@mary-poppins
Copy link

You can preview 6f10db0 at https://pr21606-6f10db0.ngbuilds.io/.

@jbogarthyde
Copy link
Contributor Author

Finally managed to fix bad commit msg

alxhub pushed a commit that referenced this pull request Feb 5, 2018
alxhub pushed a commit that referenced this pull request Feb 5, 2018
@alxhub alxhub closed this in 1940b18 Feb 5, 2018
alxhub pushed a commit that referenced this pull request Feb 5, 2018
@jbogarthyde jbogarthyde deleted the jb-fix-browser-support branch February 8, 2018 18:17
@jbogarthyde jbogarthyde restored the jb-fix-browser-support branch February 8, 2018 18:19
@jbogarthyde jbogarthyde deleted the jb-fix-browser-support branch February 9, 2018 16:10
jbogarthyde added a commit to jbogarthyde/angular that referenced this pull request Feb 23, 2018
jbogarthyde added a commit to jbogarthyde/angular that referenced this pull request Feb 23, 2018
leo6104 pushed a commit to leo6104/angular that referenced this pull request Mar 25, 2018
leo6104 pushed a commit to leo6104/angular that referenced this pull request Mar 25, 2018
@angular-automatic-lock-bot
Copy link

This issue has been automatically locked due to inactivity.
Please file a new issue if you are encountering a similar or related problem.

Read more about our automatic conversation locking policy.

This action has been performed automatically by a bot.

@angular-automatic-lock-bot angular-automatic-lock-bot bot locked and limited conversation to collaborators Sep 13, 2019
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
action: merge The PR is ready for merge by the caretaker cla: yes target: patch This PR is targeted for the next patch release
Projects
None yet
Development

Successfully merging this pull request may close these issues.

7 participants