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

Dynamically generate README #1187

Merged
merged 1 commit into from
Apr 13, 2024

Conversation

stevepolitodesign
Copy link
Contributor

@stevepolitodesign stevepolitodesign commented Apr 13, 2024

Create README based off the desc of the generators.

We chose to create a custom class instead of a traditional generator because this script is intended to be run in the application template as a Rake task. It is not intended to be run as a standalone generator, since it only makes sense to be run on concert with suspenders:install:web.

Updates all generator descriptions to use Herdoc syntax to ensure consistent line breaks.

A follow-up commit will update the descriptions to work better in a README.

Create README based off the `desc` of the generators.

We chose to create a custom class instead of a traditional generator
because this script is intended to be run in the [application
template][] as a Rake task. It is not intended to be run as a standalone
generator, since it only makes sense to be run on concert with
`suspenders:install:web`.

Updates all generator descriptions to use Herdoc syntax to ensure
consistent line breaks.

A follow-up commit will update the descriptions to work better in a
README.

[application template]: https://guides.rubyonrails.org/rails_application_templates.html
@stevepolitodesign stevepolitodesign merged commit 08be1dd into suspenders-3-0-0 Apr 13, 2024
2 checks passed
@stevepolitodesign stevepolitodesign deleted the suspenders-3-0-0-readme branch April 13, 2024 09:55
stevepolitodesign added a commit that referenced this pull request Apr 13, 2024
Follow-up to #1187.

Removes description tests. These were a helpful guide during
development, but don't provide much value now.
stevepolitodesign added a commit that referenced this pull request Apr 22, 2024
stevepolitodesign added a commit that referenced this pull request Apr 22, 2024
Follow-up to #1187

Since we derive the app name from a module name, we need to [titleize][]
it so it reads better in the `README`.

Now `ExpectedAppName` will be rendered as `Expected App Name`.

[titleize]: https://api.rubyonrails.org/classes/ActiveSupport/Inflector.html#method-i-titleize
stevepolitodesign added a commit that referenced this pull request Apr 22, 2024
Follow-up to #1187

Since we derive the app name from a module name, we need to [titleize][]
it so it reads better in the `README`.

Now `ExpectedAppName` will be rendered as `Expected App Name`.

[titleize]: https://api.rubyonrails.org/classes/ActiveSupport/Inflector.html#method-i-titleize
stevepolitodesign added a commit that referenced this pull request Apr 23, 2024
stevepolitodesign added a commit that referenced this pull request Apr 25, 2024
stevepolitodesign added a commit that referenced this pull request Apr 25, 2024
stevepolitodesign added a commit that referenced this pull request Apr 26, 2024
stevepolitodesign added a commit that referenced this pull request Apr 26, 2024
stevepolitodesign added a commit that referenced this pull request Apr 26, 2024
Follow-up to #1187

Update descriptions so that they work well in the `README.md` generated
by `suspenders:clean_up:generate_readme`.

Also fixes a typo in `Suspenders::Cleanup::GenerateReadme`.
stevepolitodesign added a commit that referenced this pull request Apr 26, 2024
Follow-up to #1187

Update descriptions so that they work well in the `README.md` generated
by `suspenders:clean_up:generate_readme`.

Also fixes a typo in `Suspenders::Cleanup::GenerateReadme`.
@stevepolitodesign stevepolitodesign mentioned this pull request May 9, 2024
17 tasks
stevepolitodesign added a commit that referenced this pull request May 10, 2024
Create README based off the `desc` of the generators.

We chose to create a custom class instead of a traditional generator
because this script is intended to be run in the [application
template][] as a Rake task. It is not intended to be run as a standalone
generator, since it only makes sense to be run on concert with
`suspenders:install:web`.

Updates all generator descriptions to use Herdoc syntax to ensure
consistent line breaks.

A follow-up commit will update the descriptions to work better in a
README.

[application template]: https://guides.rubyonrails.org/rails_application_templates.html
stevepolitodesign added a commit that referenced this pull request May 10, 2024
Follow-up to #1187

Since we derive the app name from a module name, we need to [titleize][]
it so it reads better in the `README`.

Now `ExpectedAppName` will be rendered as `Expected App Name`.

[titleize]: https://api.rubyonrails.org/classes/ActiveSupport/Inflector.html#method-i-titleize
stevepolitodesign added a commit that referenced this pull request May 10, 2024
Follow-up to #1187

Update descriptions so that they work well in the `README.md` generated
by `suspenders:clean_up:generate_readme`.

Also fixes a typo in `Suspenders::Cleanup::GenerateReadme`.
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.

1 participant