Skip to content

Commit 536ffa8

Browse files
jingyun19jingyun19
authored
Initial commit
0 parents  commit 536ffa8

7 files changed

Lines changed: 408 additions & 0 deletions

File tree

‎.github/dependabot.yml‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
# See the documentation at
2+
# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
3+
version: 2
4+
updates:
5+
# Update actions used by .github/workflows in this repository.
6+
- package-ecosystem: "github-actions"
7+
directory: "/"
8+
schedule:
9+
interval: "weekly"
10+
groups:
11+
actions-org: # Groups all Github-authored actions into a single PR.
12+
patterns: ["actions/*"]

‎.github/workflows/auto-publish.yml‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
name: CI
2+
on:
3+
pull_request: {}
4+
push:
5+
branches: [main]
6+
jobs:
7+
main:
8+
name: Build, Validate and Deploy
9+
runs-on: ubuntu-22.04
10+
permissions:
11+
contents: write
12+
steps:
13+
- uses: actions/checkout@v6
14+
- uses: w3c/spec-prod@v2
15+
with:
16+
GH_PAGES_BRANCH: gh-pages
17+
BUILD_FAIL_ON: warning

‎.gitignore‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
index.html

‎.pr-preview.json‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
{
2+
"src_file": "index.bs",
3+
"type": "bikeshed",
4+
"params": {
5+
"force": 1
6+
}
7+
}
8+

‎LICENSE.md‎

Lines changed: 157 additions & 0 deletions
Large diffs are not rendered by default.

‎README.md‎

Lines changed: 185 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,185 @@
1+
# Explainer for the TODO API
2+
3+
**Instructions for the explainer author: Search for "todo" in this repository and update all the
4+
instances as appropriate. For the instances in `index.bs`, update the repository name, but you can
5+
leave the rest until you start the specification. Then delete the TODOs and this block of text.**
6+
7+
This proposal is an early design sketch by [TODO: team] to describe the problem below and solicit
8+
feedback on the proposed solution. It has not been approved to ship in Chrome.
9+
10+
TODO: Fill in the whole explainer template below using https://tag.w3.org/explainers/ as a
11+
reference. Look for [brackets].
12+
13+
## Proponents
14+
15+
- [Proponent team 1]
16+
- [Proponent team 2]
17+
- [etc.]
18+
19+
## Participate
20+
- https://github.com/explainers-by-googlers/[your-repository-name]/issues
21+
- [Discussion forum]
22+
23+
## Table of Contents [if the explainer is longer than one printed page]
24+
25+
<!-- Update this table of contents by running `npx doctoc README.md` -->
26+
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
27+
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
28+
29+
- [Introduction](#introduction)
30+
- [Goals](#goals)
31+
- [Non-goals](#non-goals)
32+
- [User research](#user-research)
33+
- [Use cases](#use-cases)
34+
- [Use case 1](#use-case-1)
35+
- [Use case 2](#use-case-2)
36+
- [[Potential Solution]](#potential-solution)
37+
- [How this solution would solve the use cases](#how-this-solution-would-solve-the-use-cases)
38+
- [Use case 1](#use-case-1-1)
39+
- [Use case 2](#use-case-2-1)
40+
- [Detailed design discussion](#detailed-design-discussion)
41+
- [[Tricky design choice #1]](#tricky-design-choice-1)
42+
- [[Tricky design choice 2]](#tricky-design-choice-2)
43+
- [Considered alternatives](#considered-alternatives)
44+
- [[Alternative 1]](#alternative-1)
45+
- [[Alternative 2]](#alternative-2)
46+
- [Security and Privacy Considerations](#security-and-privacy-considerations)
47+
- [Stakeholder Feedback / Opposition](#stakeholder-feedback--opposition)
48+
- [References & acknowledgements](#references--acknowledgements)
49+
50+
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
51+
52+
## Introduction
53+
54+
[The "executive summary" or "abstract".
55+
Explain in a few sentences what the goals of the project are,
56+
and a brief overview of how the solution works.
57+
This should be no more than 1-2 paragraphs.]
58+
59+
## Goals
60+
61+
[What is the **end-user need** which this project aims to address? Make this section short, and
62+
elaborate in the Use cases section.]
63+
64+
## Non-goals
65+
66+
[If there are "adjacent" goals which may appear to be in scope but aren't,
67+
enumerate them here. This section may be fleshed out as your design progresses and you encounter necessary technical and other trade-offs.]
68+
69+
## User research
70+
71+
[If any user research has been conducted to inform your design choices,
72+
discuss the process and findings. User research should be more common than it is.]
73+
74+
## Use cases
75+
76+
[Describe in detail what problems end-users are facing, which this project is trying to solve. A
77+
common mistake in this section is to take a web developer's or server operator's perspective, which
78+
makes reviewers worry that the proposal will violate [RFC 8890, The Internet is for End
79+
Users](https://www.rfc-editor.org/rfc/rfc8890).]
80+
81+
### Use case 1
82+
83+
### Use case 2
84+
85+
<!-- In your initial explainer, you shouldn't be attached or appear attached to any of the potential
86+
solutions you describe below this. -->
87+
88+
## [Potential Solution]
89+
90+
[For each related element of the proposed solution - be it an additional JS method, a new object, a new element, a new concept etc., create a section which briefly describes it.]
91+
92+
```js
93+
// Provide example code - not IDL - demonstrating the design of the feature.
94+
95+
// If this API can be used on its own to address a user need,
96+
// link it back to one of the scenarios in the goals section.
97+
98+
// If you need to show how to get the feature set up
99+
// (initialized, or using permissions, etc.), include that too.
100+
```
101+
102+
[Where necessary, provide links to longer explanations of the relevant pre-existing concepts and API.
103+
If there is no suitable external documentation, you might like to provide supplementary information as an appendix in this document, and provide an internal link where appropriate.]
104+
105+
[If this is already specced, link to the relevant section of the spec.]
106+
107+
[If spec work is in progress, link to the PR or draft of the spec.]
108+
109+
[If you have more potential solutions in mind, add ## Potential Solution 2, 3, etc. sections.]
110+
111+
### How this solution would solve the use cases
112+
113+
[If there are a suite of interacting APIs, show how they work together to solve the use cases described.]
114+
115+
#### Use case 1
116+
117+
[Description of the end-user scenario]
118+
119+
```js
120+
// Sample code demonstrating how to use these APIs to address that scenario.
121+
```
122+
123+
#### Use case 2
124+
125+
[etc.]
126+
127+
## Detailed design discussion
128+
129+
### [Tricky design choice #1]
130+
131+
[Talk through the tradeoffs in coming to the specific design point you want to make.]
132+
133+
```js
134+
// Illustrated with example code.
135+
```
136+
137+
[This may be an open question,
138+
in which case you should link to any active discussion threads.]
139+
140+
### [Tricky design choice 2]
141+
142+
[etc.]
143+
144+
## Considered alternatives
145+
146+
[This should include as many alternatives as you can,
147+
from high level architectural decisions down to alternative naming choices.]
148+
149+
### [Alternative 1]
150+
151+
[Describe an alternative which was considered,
152+
and why you decided against it.]
153+
154+
### [Alternative 2]
155+
156+
[etc.]
157+
158+
## Security and Privacy Considerations
159+
160+
[Describe any interesting answers you give to the [Security and Privacy Self-Review
161+
Questionnaire](https://www.w3.org/TR/security-privacy-questionnaire/) and any interesting ways that
162+
your feature interacts with [Chromium's Web Platform Security
163+
Guidelines](https://chromium.googlesource.com/chromium/src/+/master/docs/security/web-platform-security-guidelines.md).]
164+
165+
## Stakeholder Feedback / Opposition
166+
167+
[Implementors and other stakeholders may already have publicly stated positions on this work. If you can, list them here with links to evidence as appropriate.]
168+
169+
- [Implementor A] : Positive
170+
- [Stakeholder B] : No signals
171+
- [Implementor C] : Negative
172+
173+
[If appropriate, explain the reasons given by other implementors for their concerns.]
174+
175+
## References & acknowledgements
176+
177+
[Your design will change and be informed by many people; acknowledge them in an ongoing way! It helps build community and, as we only get by through the contributions of many, is only fair.]
178+
179+
[Unless you have a specific reason not to, these should be in alphabetical order.]
180+
181+
Many thanks for valuable feedback and advice from:
182+
183+
- [Person 1]
184+
- [Person 2]
185+
- [etc.]

‎index.bs‎

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
<pre class='metadata'>
2+
Title: The TODO API
3+
Shortname: todo
4+
Level: None
5+
Status: w3c/UD
6+
Repository: explainers-by-googlers/todo-your-repo-name
7+
URL: https://explainers-by-googlers.github.io/todo-your-repo-name
8+
Editor: TODO: Your Name, Google https://google.com, TODO@google.com
9+
Abstract: TODO: A short description of your spec, one or two sentences.
10+
Markup Shorthands: markdown yes, css no
11+
Complain About: accidental-2119 yes, missing-example-ids yes
12+
Assume Explicit For: yes
13+
Die On: warning
14+
WPT Path Prefix: TODO-API-LABEL
15+
WPT Display: closed
16+
Include MDN Panels: if possible
17+
Include Can I Use Panels: yes
18+
</pre>
19+
20+
Introduction {#intro}
21+
=====================
22+
23+
For now, see the <a href=[REPOSITORYURL]>explainer</a>.
24+
25+
See [https://garykac.github.io/procspec/](https://garykac.github.io/procspec/),
26+
[https://dlaliberte.github.io/bikeshed-intro/index.html](https://dlaliberte.github.io/bikeshed-intro/index.html),
27+
and [https://speced.github.io/bikeshed/](https://speced.github.io/bikeshed/) to get started on your
28+
specification.

0 commit comments

Comments
 (0)