Skip to content

Conversation

bjohansebas
Copy link
Member

Modernize this page by making the following changes:

  • Update broken links
  • Remove references to Upstart, as this service has been in maintenance mode for several years
  • Remove references to Strongloop, updating documentation with current tools

Copy link

netlify bot commented Nov 10, 2024

Deploy Preview for expressjscom-preview ready!

Name Link
🔨 Latest commit 1c6ebf7
🔍 Latest deploy log https://app.netlify.com/sites/expressjscom-preview/deploys/67af7780e8710f000847ea6f
😎 Deploy Preview https://deploy-preview-1679--expressjscom-preview.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.

@bjohansebas bjohansebas self-assigned this Nov 10, 2024
@bjohansebas bjohansebas force-pushed the update-performance-info branch from 4133f2f to 0b2aeca Compare November 13, 2024 23:12
@bjohansebas bjohansebas marked this pull request as ready for review November 20, 2024 01:25
@bjohansebas bjohansebas changed the title [WIP]: Update production best practices Update production best practices Nov 20, 2024
@bjohansebas bjohansebas requested review from a team and carlosstenzel November 20, 2024 01:26
Copy link
Member

@UlisesGascon UlisesGascon left a comment

Choose a reason for hiding this comment

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

I like the changes, but I think that we need to have a good agreement on this (cc: @expressjs/express-tc )

Copy link
Member

@wesleytodd wesleytodd left a comment

Choose a reason for hiding this comment

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

I think this is an improvement for sure. Great work @bjohansebas!

I think we probably need to re-think the role our docs play in the ecosystem. Best practices have evolved quite a bit since this was all written, and it will evolve again in the coming years. We probably don't want to be the source for too much content like this unless we are able to keep it updated.

That said, for now, I am very much in support of improving this type of doc so LGTM!

Copy link
Member

@wesleytodd wesleytodd left a comment

Choose a reason for hiding this comment

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

oops forgot to change it to approve

Copy link
Contributor

@dpopp07 dpopp07 left a comment

Choose a reason for hiding this comment

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

Just a quick proof read

bjohansebas and others added 2 commits February 14, 2025 11:11
Co-authored-by: Dustin Popp <dustinpopp@ibm.com>
Co-authored-by: Dustin Popp <dustinpopp@ibm.com>
@Phillip9587
Copy link
Contributor

Please update the following link in the Cache Request Results section: https://www.nginx.com/resources/wiki/start/topics/examples/reverseproxycachingexample/ it is invalid and redirects to https://docs.nginx.com/

Maybe replace it with: https://blog.nginx.org/blog/nginx-caching-guide

@wesleytodd
Copy link
Member

wesleytodd commented Feb 14, 2025

Looks like we have approvals and have resolved the concerns. The merge block now is just rebasing I think.

EDIT: oh wait, I jus read @Phillip9587's comment. Seems like a good last minute change.

EDIT 2: lol, commented while the update was being pushed!

@bjohansebas
Copy link
Member Author

The only thing blocking this PR is @ctcpip 's request change. I can remove @ctcpip 's request change, but I would prefer that he remove it himself. I can wait a few more minutes.

@wesleytodd
Copy link
Member

Oh yeah, we should never remove others reviews. I saw a yellow "comment" review in the sidebar but missed that there was still a previous "change requested" review that was blocking and hidden in the collapsed comments.


As explained below, when you install StrongLoop PM as an operating system service using your init system, it will automatically restart when the system restarts. Thus, it will keep your application processes and clusters alive forever.
Historically, it was popular to use a Node.js process manager like [PM2](https://github.com/Unitech/pm2). See their documentation if you wish to do this. However, modern best practices have changed, and we now recommend using your system's init for process management
Copy link
Member

Choose a reason for hiding this comment

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

I know this was suggested by @wesleytodd, but this seems... slightly heavy-handed (?), and at least could be worded better (using your init system vs using your system's init, for example. Do we really want to take a position of saying using pm2 is not a "best practice"? If that's the case (which I am challenging here), then we shouldn't even be mentioning pm2.

Copy link
Member Author

Choose a reason for hiding this comment

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

That would require rewriting a large part where PM2 was mentioned, so removing it is not an option at the moment.

Copy link
Member

Choose a reason for hiding this comment

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

Do we really want to take a position of saying using pm2 is not a "best practice"?

Clearly IMO yes lol, but I fully understand your reasoning for being hesitant. Having used basically all variants at different points of my career, I can comfortably say that operating system process management is always better. And even if you use pm2 you nearly certainly have to also use your OS process manager to kick off pm2, so why make it more complicated?

then we shouldn't even be mentioning pm2.

This is what I would prefer, but I thought that was a larger change from our existing docs.

at least could be worded better (using your init system vs using your system's init, for example.

That's a good change, I didn't really spend a ton of time on that suggestion, my bad.

Copy link
Member Author

Choose a reason for hiding this comment

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

I can dedicate another PR to removing PM2, but for now, I changed the wording to the suggestion that Chris proposed.

Copy link
Member

Choose a reason for hiding this comment

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

Sounds good to me.

Copy link
Member Author

Choose a reason for hiding this comment

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

@ctcpip, do you consider this resolved?

Copy link
Member

@wesleytodd wesleytodd left a comment

Choose a reason for hiding this comment

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

Changing to approved since we have a plan to address all the things I was concerned about in future PRs.

Co-authored-by: Chris de Almeida <ctcpip@users.noreply.github.com>
@bjohansebas bjohansebas merged commit 1409e38 into gh-pages Feb 14, 2025
8 checks passed
@bjohansebas bjohansebas deleted the update-performance-info branch February 14, 2025 17:06
chrisdel101 pushed a commit to chrisdel101/expressjs.com that referenced this pull request Feb 16, 2025
Co-authored-by: Chris de Almeida <ctcpip@users.noreply.github.com>
Co-authored-by: Phillip Barta <barta.phillip@gmail.com>
Co-authored-by: Dustin Popp <dustinpopp@ibm.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Issues/pr concerning content needs tech review A doc edit that requires technical review before merging
Projects
None yet
Development

Successfully merging this pull request may close these issues.

8 participants