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

Added Guides and Tutorials section #32

Open
wants to merge 4 commits into
base: main
Choose a base branch
from

Conversation

igor-alexandrov
Copy link
Contributor

@igor-alexandrov igor-alexandrov commented Sep 25, 2023

The PR adds a "Guides and Tutorials" section to the website. Articles are ordered by publishing time (newer at the top). I got an idea from basecamp/kamal#355.

Currently, I added three articles about Kamal/MRSK that I found. Please add more comments to this PR, and I will add them.

Screenshot 2023-09-25 at 14 58 40

@Michoels
Copy link

👍 This is badly needed.

@joshio1
Copy link

joshio1 commented Nov 2, 2023

@igor-alexandrov
Copy link
Contributor Author

@joshio1 added a link to your guide and another guide about Kamal and Hetzner.

_docs/guides.md Outdated
* [Basic guide to deploy a Rails 7 application using Kamal on Hetzner Cloud](https://joshio1.blog/basic-guide-to-deploy-a-rails-7-application-using-kamal-on-hetzner-cloud/) <br/> _Omkar Joshi_, _2 Nov 2023_
* [How To Use Basecamp’s Kamal With AWS and GitHub](https://jetrockets.com/blog/how-to-use-basecamp-s-kamal-with-aws-and-github) <br/> _Igor Alexandrov_, _21 Sep 2023_
* [Deploying a Rails app with Kamal](https://greg.molnar.io/blog/deploying-a-rails-app-with-kamal) <br/> _Greg Molnar_, _20 Sep 2023_
* [Deploying NextJS app using Mrsk (Kamal)](https://medium.com/@ruslanfg/deploying-nextjs-using-mrsk-819aa9eb83ba)<br/> _Ruslan Gainutdinov_, _10 Apr 2023_
Copy link
Contributor

Choose a reason for hiding this comment

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

Hi @igor-alexandrov - I think we should remove this last one as it predates the move from MRSK to Kamal.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@djmb yes, and add a bunch of new articles, I will update the PR.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@djmb I removed the guide you were referring to and added two new articles.

@dhh
Copy link
Member

dhh commented Oct 5, 2024

I think adding something like this needs to just focus on Kamal 2+.

@Michoels
Copy link

Michoels commented Oct 6, 2024

It makes sense to retire Kamal 1 articles.

However, I think the proposed guides/tutorials section should still be versioned (like the rest of the Kamal docs).
There will undoubtedly by future versions of Kamal, and it will make future reader's lives much easier if they can easily see which articles are relevant.
This also might incentivize authors to keep their articles up to date, as their work would no longer be shown on latest version.

Screenshot 2024-10-06 at 10 37 32 AM

@nickhammond
Copy link
Contributor

I would vote for keeping a main set of official guides within this repository and then have a collection of links to external resources for tutorials. Reason being that the guides can continually be updated from this repository with a pull request from anyone while tutorials are left up to the author to keep them up to date.

We could also add some metadata related to categories, language/platform, and Kamal features utilized with each guide. Not as extensive as Docker guides but somewhere in between.

This also makes me think of if the Rails guides just linked out to tutorials instead of how the guides are currently maintained which results in a really polished guide from many contributors.

image

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.

7 participants