Skip to content

Document troubleshooting build problems #5256

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
agjohnson opened this issue Feb 8, 2019 · 1 comment
Closed

Document troubleshooting build problems #5256

agjohnson opened this issue Feb 8, 2019 · 1 comment
Labels
Accepted Accepted issue on our roadmap Needed: documentation Documentation is required

Comments

@agjohnson
Copy link
Contributor

A non-exhaustive list of build issue that users can run into are:

  • My build doesn't seem to be updating, what can I do? This is likely a problem on our side, but perhaps wiping the version is a good first step
  • My built documentation doesn't look right, what's up? It could be out of sync across our web server, which surfaces in a number of different ways. For instance, if JS or CSS isn't in sync on both webs, you might see the file change every couple of requests, or your documentation site might appear really broken 30%-50% of the time. You should rebuild your project as a first step.
  • My builds aren't happening automatically. We can point to webhook docs for this one likely
@agjohnson agjohnson added Needed: documentation Documentation is required Accepted Accepted issue on our roadmap labels Feb 8, 2019
@agjohnson agjohnson added this to the Better user documentation milestone Feb 8, 2019
@humitos
Copy link
Member

humitos commented Feb 12, 2019

Closing this as duplicate of #4729.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Accepted Accepted issue on our roadmap Needed: documentation Documentation is required
Projects
None yet
Development

No branches or pull requests

2 participants