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

Rails guide upgrade (part 2) #22114

Merged
merged 5 commits into from
Mar 12, 2025

Conversation

igor-alexandrov
Copy link
Contributor

@igor-alexandrov igor-alexandrov commented Feb 27, 2025

Description

This PR has two goals. First of all it continues work that has been done in #21559. Besides this, and this is more significant, I tried to improve the structure of the documentation that is currently used for different language-specific guides like PHP, Go, Python and others, including, of course, Ruby itself.

Each of these guides currently has a Configure CI/CD section. Inside this section there is a GitHub Actions workflow example that has nothing in common with a CI/CD pipeline. It's just an example of how to build and push an image to a Docker Hub registry. We should be clear in our documentation and not mislead our users. This was the main reason why I renamed this section to "Automate your builds with GitHub Actions". I also updated the content of this section to reflect the new name and to make it more clear what the user can expect from this guide. I suggest the same be done for all other language-specific guides.

Besides this, I changed the order of the sections in the Ruby guide. The "Develop your app" section has been moved down to the bottom of the guide. This makes more sense to me because of two reasons:

  1. It is more important to start using Docker Hub right after you added the Dockerfile to your project (section number one in all language-specific guides).

  2. I can hardly imagine anybody using Docker to run the app locally for development purposes (at least for Ruby). What is really essential and useful is to know how to run services, that are required by your app, like a database, a cache server, or a local LLM. This is why the "Develop your app" section should be rewritten to explain how to run the infrastructure services that are required by the app and not the app itself.

Below there are screenshots reflecting the changes that have been made in this PR.

Before
Screenshot 2025-02-27 at 11 26 39

After
Screenshot 2025-02-27 at 11 26 01

Related issues or tickets

#21559

Reviews

  • Technical review
  • Editorial review
  • Product review

Copy link

netlify bot commented Feb 27, 2025

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 6576f5a
🔍 Latest deploy log https://app.netlify.com/sites/docsdocker/deploys/67d1602186588900088bd844
😎 Deploy Preview https://deploy-preview-22114--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@craig-osterhout craig-osterhout requested a review from a team March 6, 2025 22:11
Copy link
Contributor

@craig-osterhout craig-osterhout left a comment

Choose a reason for hiding this comment

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

Overall, LGTM.

I left one small comment for a formatting nit.

In addition, the text in the Next steps sections needs to be updated to reflect the new topic order for the following topics:

  • configure-github-actions.md
  • develop.md
  • containerize.md

For example, in containerize.md, change In the next section, you'll learn how you can develop your application using containers. to something like In the next section, you'll take a look at how to set up a CI/CD pipeline using GitHub Actions.

@igor-alexandrov
Copy link
Contributor Author

Thanks, @craig-osterhout. I updated the markup and changed the wording in "Next steps" sections.

Copy link
Contributor

@craig-osterhout craig-osterhout left a comment

Choose a reason for hiding this comment

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

LGTM. Thank you.

@craig-osterhout craig-osterhout merged commit c3431b0 into docker:main Mar 12, 2025
14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants