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

Figure out how to enable fast docs development locally #4

Closed
molant opened this issue Apr 20, 2021 · 0 comments · Fixed by #9
Closed

Figure out how to enable fast docs development locally #4

molant opened this issue Apr 20, 2021 · 0 comments · Fixed by #9
Labels
✨ enhancement New feature or request

Comments

@molant
Copy link
Contributor

molant commented Apr 20, 2021

One of the problems with the current way we have docs is that it's really complicated to see how any changes to the documentation look like in the website:

  1. Docs are in electron/electron
  2. The contents of electron/i18n get updated periodically and pushed to crowdin
  3. When new translations are available, a new package electron-i18n is published
  4. The website electron/electronjs.org then picks that the package has been updated and when the change is merged it gets finally deployed

While we still want the documentation to live in electron/electron, we want contributors to have an easy way to see how the docs would look like in the website.

Ref #2

@molant molant added the ✨ enhancement New feature or request label Apr 20, 2021
@molant molant mentioned this issue Apr 20, 2021
23 tasks
molant added a commit that referenced this issue Apr 22, 2021
This PR allows developers to pass a parameter to indicate where in the
file system the `prebuild` script should look for the documentation. It
assumes it is a clone of `electron/electron` so the content should be
under a `/docs` folder. E.g.:

```console
yarn prebuild ../electron
```

In the future there might be a `watch` option enabled by default. This
is the MVP for #4.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Fix #4
molant added a commit that referenced this issue Apr 22, 2021
This PR allows developers to pass a parameter to indicate where in the
file system the `prebuild` script should look for the documentation. It
assumes it is a clone of `electron/electron` so the content should be
under a `/docs` folder. E.g.:

```console
yarn prebuild ../electron
```

In the future there might be a `watch` option enabled by default. This
is the MVP for #4.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Fix #4
molant added a commit that referenced this issue Apr 26, 2021
This PR allows developers to pass a parameter to indicate where in the
file system the `prebuild` script should look for the documentation. It
assumes it is a clone of `electron/electron` so the content should be
under a `/docs` folder. E.g.:

```console
yarn prebuild ../electron
```

In the future there might be a `watch` option enabled by default. This
is the MVP for #4.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Fix #4
@molant molant closed this as completed in #9 Apr 26, 2021
molant added a commit that referenced this issue Apr 26, 2021
This PR allows developers to pass a parameter to indicate where in the
file system the `prebuild` script should look for the documentation. It
assumes it is a clone of `electron/electron` so the content should be
under a `/docs` folder. E.g.:

```console
yarn prebuild ../electron
```

In the future there might be a `watch` option enabled by default. This
is the MVP for #4.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Fix #4
Close #9
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
✨ enhancement New feature or request
Projects
None yet
Development

Successfully merging a pull request may close this issue.

1 participant