Update installation docs to use templates + esbuild instructions

[kevinfiol]

Removes wordy "Step by Step" section of the installation page, as well instructions on using budo, and adds Mithril starter templates that are easy to clone. Also rewrites Quick start section to use esbuild instead of Webpack.

Description

• Remove instances of using npm install with the --save flag as that flag is no longer necessary since npm v5.

• Remove Step by step section

• Remove Alternate ways to use Mithril.js section

• Rewrite Quick start with Webpack to use esbuild instead.

• Add "Create a project locally" section that lists three different templates a user can get started with:

  • mithril-esbuild-starter
  • mithril-vite-starter
  • mithril-rollup-starter

Review the rendered markdown here.

Motivation and Context

• Why is this change required? What problem does it solve?
  • Simplifies installation documentation
  • Moves the documentation to use newer, more up-to-date and performant tools. Webpack has a much larger dependency graph while being far less performant than esbuild, rollup, or Vite.

For some notes on why I went with esbuild as the "default":

• Usage is dead simple since it's primary usage is through the CLI; no config needed to write an npm script
• It's a small-ish static binary and is well suited for single-page applications, which Mithril embraces
• Appeals to minimalists and folks unfamiliar with JS ecosystem. See this post
• It will arguably be around longer than Vite (fwiw, Vite sits on top of esbuild)

How Has This Been Tested?

Ran npm run build:docs locally and reviewed built documentation

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)
• Documentation change

Checklist:

• My code follows the code style of this project.
• My change requires a change to the documentation.
• I have updated the documentation accordingly.
• I have read the CONTRIBUTING document.
• I have added tests to cover my changes.
• All new and existing tests passed.
• I have updated docs/changelog.md

[tbreuss]

I went through your instructions by all doing it by myself. Everything worked as expected. Nice and consise.

[tbreuss]

Seems like port 8080 is the default. Maybe a hint could be helpful how to solve this, if port 8080 is already in use (in my case traefik).

[kevinfiol]

I updated the port used by the esbuild template, and the dev script should log the port to the console by default.

[JAForbes]

Would be so great to have the webpack instructions gone, this looks great.

[kevinfiol]

Been a while since I looked at this. I'll make a note to take a look today/this week to fix the formatting and update the templates.

FWIW, I think any templates should probably be under the MithrilJS org.

[kevinfiol]

OK pushed up my changes/fixes, and also went ahead and updated the esbuild + rollup template repos.

[JAForbes]

@dead-claudia does this need to target the new docs repo now?

[dead-claudia]

@JAForbes Yes.

[dead-claudia]

@kevinfiol Please recreate this against https://github.com/MithrilJS/docs

[kevinfiol]

Thanks @dead-claudia . Opened MithrilJS/docs#7