Skip to content
This repository has been archived by the owner on Oct 1, 2024. It is now read-only.

[quilt] Polish repo README and package descriptions #1506

Merged
merged 1 commit into from
Jun 22, 2020
Merged

Conversation

b-ryu
Copy link
Contributor

@b-ryu b-ryu commented Jun 10, 2020

Description

Fixes #1500

This PR does some minor polish on package descriptions and the repo-level README.md.

  • Polish package descriptions (capitalization, getting rid of trailing periods, etc.)
  • Reformat/polish repo README.md (add descriptions, etc.)
  • Add validators/cleaners to plop package generator
  • Prevent characters in descriptions from getting escaped in templates (e.g. ' vs. ')
  • Polish descriptions in package-level README.mds

  • Minor doc update to quilt_rails regarding new NetworkUniversalProvider

Tophat

You can test the changes made to the plop template/generators using the following steps:

  1. dev cd quilt && git fetch --all && git checkout 1500-readme
  2. yarn generate docs to generate a new repo README.md with package names and descriptions pulled from individual package.jsons
  3. yarn generate package to create a test package
    • Package name and description should be checked and cleaned if necessary (i.e. npm rules, leading/trailing whitespace and periods removed)
    • Generated files and directories should be properly named
    • Package README.md should preserve description formatting


[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE.md)
[![Build Status](https://travis-ci.org/Shopify/quilt.svg?branch=master)](https://travis-ci.org/Shopify/quilt)
[![codecov](https://codecov.io/gh/Shopify/quilt/branch/master/graph/badge.svg)](https://codecov.io/gh/Shopify/quilt)
[![Greenkeeper badge](https://badges.greenkeeper.io/Shopify/quilt.svg)](https://greenkeeper.io/)
Copy link
Contributor Author

Choose a reason for hiding this comment

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

@b-ryu b-ryu force-pushed the 1500-readme branch 3 times, most recently from c8dfdca to a353338 Compare June 11, 2020 20:20
[![lerna](https://img.shields.io/badge/maintained%20with-lerna-cc00ff.svg)](https://lernajs.io/)

A loosely related set of packages for JavaScript / TypeScript projects at Shopify.
Copy link
Contributor Author

@b-ryu b-ryu Jun 11, 2020

Choose a reason for hiding this comment

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

A little nitpicky, but if we change this here we'll also probably want to change it in the repo description on the GitHub page

@b-ryu b-ryu marked this pull request as ready for review June 11, 2020 22:08
@b-ryu b-ryu requested review from marutypes and ismail-syed June 11, 2020 22:08

function validatePackageName(name) {
return (
/^(?:@[a-z0-9-*~][a-z0-9-*._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/g.test(
Copy link
Contributor Author

@b-ryu b-ryu Jun 12, 2020

Choose a reason for hiding this comment

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

This regex was copied directly from a lint warning in VS Code:

Screen Shot 2020-06-12 at 11 55 01 AM

@b-ryu b-ryu force-pushed the 1500-readme branch 3 times, most recently from 503a2dc to c77d0d8 Compare June 17, 2020 15:27
@b-ryu b-ryu merged commit 15b57cf into master Jun 22, 2020
@b-ryu b-ryu deleted the 1500-readme branch June 22, 2020 21:44
@b-ryu b-ryu temporarily deployed to production June 22, 2020 22:02 Inactive
@CameronGorrie CameronGorrie temporarily deployed to gem June 24, 2020 21:25 Inactive
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add one line description to each package on the main README.md
3 participants