Skip to content

Commit

Permalink
Merge pull request #106 from DanielRyanSmith/patch-1
Browse files Browse the repository at this point in the history
Remove feedback requirement notes
  • Loading branch information
jpchase authored Feb 15, 2024
2 parents 0327323 + a1b0f49 commit dbbff7d
Showing 1 changed file with 12 additions and 43 deletions.
55 changes: 12 additions & 43 deletions developer-guide.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Origin Trials Guide for Web Developers

Origin trials allow developers to try out new features and give feedback on usability, practicality, and effectiveness to the web standards community. Your feedback is valuable input into the final decision about the feature design, or even whether we want to proceed with standardizing and enabling the feature by default. When a feature is available as an origin trial, you are able to register to have it enabled for all users on your origin for a fixed period of time. Note that when the trial finishes we will contact you with a request to provide this feedback.
Origin trials allow developers to try out new features and give feedback on usability, practicality, and effectiveness to the web standards community. Your feedback is valuable input into the final decision about the feature design, or even whether we want to proceed with standardizing and enabling the feature by default. When a feature is available as an origin trial, you are able to register to have it enabled for all users on your origin for a fixed period of time.

Once your origin has opted into a trial of an experimental feature you can then build demos and prototypes that your friends and beta testing users can try for the duration of the trial without them needing to flip special flags in Chrome.

Expand Down Expand Up @@ -95,6 +95,7 @@ Not today, but if this model proves to work well then it’s possible that other

Yes, you can technically request a token for an origin that you don't own. However, generating the token won't cause the feature to be enabled on that origin - unless it is served in the pages on that origin (either in the \<head\> or as an HTTP header). Also note that these features have held up to the same high security and privacy standards as any other feature in Chrome.

<a name="token-expiry"></a>
### 11. Why do tokens expire before the trial ends?

- The trial may have been extended after your last registration. Each token contains the
Expand All @@ -112,12 +113,7 @@ Yes, you can technically request a token for an origin that you don't own. Howev
link to the registration page in the [developer console](https://developers.chrome.com/origintrials/#/trials/active).
You can also go directly to the page in the console, by finding the trial in the list on
[My Registrations](https://developers.chrome.com/origintrials/#/trials/my).
- On the registration page, you may need to provide feedback before you can renew. Use the
Feedback button to complete a survey to provide feedback.
- On the registration page, the Renew button will be available when feedback has been provided.
Use the Renew button to generate a new token.
- Feedback is required to renew tokens. If you have multiple origins registered for a trial,
we'll only ask you for once per period, rather than for every origin.
- On the registration page, use the Renew button to generate a new token.

### 13. I have multiple testing/staging domains, or subdomains that are programmatically generated. Do I need to request a token for every subdomain?

Expand Down Expand Up @@ -245,42 +241,15 @@ token. If available, the choices are:
when a valid token is provided. The exclusion percentage varies for each trial, but is
typically less than 5%.

<a name="valid-until"></a>
### 21. What does the _Valid Until_ date mean for my tokens?

- Tokens are guaranteed to be accepted by Chrome up to the _Valid Until_ date. This date is calculated
based on your feedback, initially set to 6 weeks after the token is created.
- Feedback is required every 6 weeks to extend the _Valid Until_ date in order to keep
participating in the trial.
- Before the _Valid Until_ date arrives, we'll send an email to invite you to provide feedback
and continue participating in the trial.
- Tokens without any feedback in the past 6 weeks will automatically be disabled by a remote
update process after a grace period.
- We will send a last warning email before disabling the token. This will be your last chance
to provide feedback and keep the token active. After that your token will no longer be accepted by
Chrome, and will not enable the experimental feature on any page.
- You can still provide feedback after the token is disabled. However, the token will not be
re-enabled immediately, even though the _Valid Until_ date is updated. The process to disable
and re-enable tokens runs periodically, and it takes some time for the remote updates to
reach the majority of Chrome clients.
- We issue tokens this way for a number of reasons, most importantly:
- To prevent experimental features from becoming "burned in" to the web platform. With
shorter-lived tokens, we can ensure that no site can use a feature for more than a month or
two, without checking in with us.
- To provide an opportunity to collect feedback on features from web developers. Feedback is
required to extend the lifespan of the token.
- To ensure active trial participants can benefit from the trial without the overhead of
repeatedly deploying new tokens.

<a name="valid-until-feedback"></a>
### 22. How do I keep my tokens active for the entire trial?

- On the registration page, you can provide feedback for the trial. Use the Feedback button to
complete a survey to provide feedback.
- Providing feedback will extend the Valid Until date by 6 weeks. You will see the updated
_Valid Until_ date on the registration page after you submit the feedback. If you have
multiple origins registered for a trial, we'll only ask you for once per period, rather than
for every origin.

<a name="expiry-date"></a>
### 21. What does the expiry date mean for my tokens?

Tokens are considered valid by Chrome up to the expiry date. The expiry date is usually the same as the end date of the origin trial. See [Question 11](#token-expiry).

### 22. Do I need to provide feedback for the trial if I request a token?

As of February 12, 2024, submitting feedback for a trial is optional, but encouraged. Over the course of your participation in the trial, you may receive notifications to ask for your feedback on the feature.

<a name="verification"></a>
### 23. How are tokens verified?
Expand Down

0 comments on commit dbbff7d

Please sign in to comment.