Skip to content
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

Explainer explainer should explicitly encourage folks to write explainers in plain text or markdown in their spec repro & discourage folks from writing explainers in tools like Google Docs #30

Open
hober opened this issue Jan 26, 2021 · 2 comments

Comments

@hober
Copy link
Contributor

hober commented Jan 26, 2021

We've encouraged folks a number of times to do this; perhaps we should capture that encouragement in the explainer explainer itself.

Cases where this has come up:

@hober
Copy link
Contributor Author

hober commented Jan 26, 2021

cc @alice

@LeaVerou
Copy link
Member

LeaVerou commented Jul 5, 2023

As discussed today, the reasons are:

  1. Google Docs is proprietary. Yes, so is GitHub, but git is not, the repo always lives somewhere else as well and can be recovered. If Google Docs goes down, the document goes down too.
  2. There are many countries that block Google Docs, but fewer that block GitHub.
  3. Everyone in standards has a GitHub account, but many don't want a Google account due to privacy concerns.
  4. When people share explainers in Google Docs, they are often inadvertently locked down to be company internal or shared with specific people. A GitHub repo can also be locked down, but that's not something that typically happens with open standards documents.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants