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

Support for Docusaurus gh-pages on Github Enterprise #689

Merged
merged 5 commits into from
Jun 2, 2018

Conversation

ranolf
Copy link
Contributor

@ranolf ranolf commented May 22, 2018

Motivation

In attempting to use Docusaurus for internal documentation in my employer's Github Enterprise server, I discovered that publish-gh-pages script assumes github.com.

Have you read the Contributing Guidelines on pull requests?

Yes. I found no issue even matching 'enterprise', which I would expect if others had tried this.

Test Plan

I verified by actually publishing to my company's Github Enterprise server.

Related PRs

(If this PR adds or changes functionality, please take some time to update the docs at https://github.com/facebook/docusaurus, and link to your PR here.)

I updated the appropriate docs files in the master branch:

  • docs/api-site-config.md
  • examples/basics/siteConfig.js

I assume that your CI process uses docs in master and runs a publish-gh-pages; and thus there is no need for a separate PR for docs?

Let me know, I'm happy to include a separate PR if necessary.

@facebook-github-bot
Copy link
Contributor

Thank you for your pull request and welcome to our community. We require contributors to sign our Contributor License Agreement, and we don't seem to have you on file. In order for us to review and merge your code, please sign up at https://code.facebook.com/cla. If you are contributing on behalf of someone else (eg your employer), the individual CLA may not be sufficient and your employer may need the corporate CLA signed.

If you have received this in error or have any questions, please contact us at cla@fb.com. Thanks!

@docusaurus-bot
Copy link
Contributor

docusaurus-bot commented May 22, 2018

Deploy preview for docusaurus-preview ready!

Built with commit f1d0b01

https://deploy-preview-689--docusaurus-preview.netlify.com

@facebook-github-bot facebook-github-bot added the CLA Signed Signed Facebook CLA label May 22, 2018
@facebook-github-bot
Copy link
Contributor

Thank you for signing our Contributor License Agreement. We can now accept your code for this (and any) Facebook open source project. Thanks!

@ranolf
Copy link
Contributor Author

ranolf commented May 22, 2018

Finally understand how prettier works. Resubmitting.

Copy link
Contributor

@JoelMarcey JoelMarcey left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ranolf Thanks! This seems like a good PR. I just have one suggestion.

@@ -64,6 +64,8 @@ headerLinks: [

`url` - url for your site.

`githubHost` - (optional) if you're using GitHub Enterprise, hostname of your server.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Given that this is optional, I wonder if this should go in the Optional Fields section? I kinda get why you put it here, but maybe just to be consistent, we should move it.

Copy link
Contributor

@yangshun yangshun left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ranolf The code looks good. But for consistency, could you change all Github/github to GitHub (capital G and H)? Thank you!

Copy link
Contributor

@yangshun yangshun left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

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

Successfully merging this pull request may close these issues.

None yet

6 participants