Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Fix generate-readme script, refresh examples.json and README.md #703

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

Open
domdomegg wants to merge 2 commits into serverless:v3
base: v3
Choose a base branch
Loading
from domdomegg:domdomegg/fix-scripts

Conversation

@domdomegg
Copy link

@domdomegg domdomegg commented May 25, 2022

At a high-level, this fixes up the examples repository. Currently, both the npm run docs and npm run lint scripts don't even run.

⚡ This PR

  • Pushes down titles and descriptions into the package.json definitions, and generates examples.json from them. This allows npm run docs to run successfully.
  • Allows npm run lint to run (but it doesn't pass at the moment, given lots of examples have noncompliant code... but figured fixing all these was for another day)
  • Refreshes the README to get the latest updates to the community plugins / examples in this repo listed

⚠ Potentially breaking changes

  • Removing framework, authorLink, authorName, authorAvatar from examples.json. It isn't used in this repository, and I don't think any of them are necessary for the Serverless examples site but as it's not open-source AFAIK I'm unable to know for sure they're unused.

🔮 Future work

  • Upgrading global packages (e.g. eslint 5 -> 8, eslint-config-airbnb-base 10 -> 15, markdown-magic 0.1 -> 2)
  • Fixing all the eslint issues
  • Adding CI (maybe GitHub actions?) to make sure docs and lint scripts still work

Copy link
Author

@pgrzesik / @mnapoli are you able to take a look at this PR, which puts this repository into much better health?

Copy link
Contributor

Hello @domdomegg - sorry for late response. This is a massive change and we're currently in the process of rethinking how we should handle the examples repository. It also includes potential breaking changes and I'm not sure if we will have the bandwidth to properly evaluate the changes in the coming days.

What do you think @mnapoli ?

Copy link
Contributor

mnapoli commented Jun 30, 2022

Sorry for the delay, yeah this is a massive PR, I wouldn't be confident merging this, especially with how these files are used to generate pages on serverless.com

Maybe if this was all split in smaller pull requests it might be easier? Not sure though 😕

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

AltStyle によって変換されたページ (->オリジナル) /