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

Clarify process for deploying a pre-release #1100

Merged
merged 1 commit into from
Jan 18, 2019

Conversation

aliuk2012
Copy link
Contributor

Something I picked up while pairing with Nick to update the Accordion's preview link.

Changes are needed in two different repos and the existing README does
not explain this well.

There should now be a branch `pre-release-[your-branch-name-here]` pushed to remote, which you can install with:
There should now be a branch `pre-release-[your-branch-name-here]` pushed to remote.

5. In GOVUK Design System:
Copy link
Contributor

Choose a reason for hiding this comment

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

I think this is useful, but I think there are use cases for pre-releases that do not involve a change to the Design System, and this change will be confusing for those users.

For example, if a team wanted us to make a change to an existing component and we wanted to be able to share a pre-release with them so they could test it, they would install the pre-release branch in their own application, not the Design System.

I suggest making it clear that this step is optional, splitting it out entirely or keeping it generic.

(Minor: GOV.UK, not GOVUK)

```

6. Test the changes updates using `npm test`
Copy link
Contributor

Choose a reason for hiding this comment

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

I'm not sure it's clear that this is in the Design System rather than back in Frontend – I certainly interpreted as running these in the Frontend repo initially.

@NickColley NickColley force-pushed the update-pre-release-docs branch from ed97fd8 to e380587 Compare January 17, 2019 17:09
Changes are needed in two different repos and the existing README does
not explain this well.
@NickColley NickColley force-pushed the update-pre-release-docs branch from e380587 to 5f99ae7 Compare January 17, 2019 17:10
@NickColley
Copy link
Contributor

NickColley commented Jan 17, 2019

With Alistair's permission I've updated this based on @36degrees 's feedback.

It's simpler but I think takes time to make clear to run this command in another project, which I think could be the main cause for confusion.

Let me know if this is good to go @aliuk2012 @36degrees

Copy link
Contributor

@36degrees 36degrees left a comment

Choose a reason for hiding this comment

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

Nice improvement – thanks both! 👏

@NickColley NickColley merged commit 815ecb4 into master Jan 18, 2019
@NickColley NickColley deleted the update-pre-release-docs branch January 18, 2019 10:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants