docs: Update website (#288)

* Create WebsiteInstructions.md

* Update index.markdown
This commit is contained in:
Joseph Tooby-Smith 2025-01-22 07:46:47 +00:00 committed by GitHub
parent 2fcafb1796
commit 7b396501e7
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 37 additions and 6 deletions

View file

@ -0,0 +1,19 @@
# HepLean website
The HepLean website is made using [Jeykll](https://jekyllrb.com) and is generated via the workflow
`./.github/docs.yml`.
## Hosting the website locally
The installation instructions for jekyll can be found [here](https://jekyllrb.com/docs/installation/#requirements).
Once jekyll is installed:
- navigate your terminal to the `./docs` directory of HepLean using e.g. `cd ./docs`.
- Run `bundle exec jekyll serve`
- Open `http://localhost:4000` in your webbrowser.
## HepLean domain
The HepLean website is hosted at `https://heplean.com`. This domain is registered via
squarespace domains by Joseph Tooby-Smith.

View file

@ -9,16 +9,28 @@
# What is HepLean? # What is HepLean?
HepLean is an open-source project to digitalise definitions, theorems, proofs, and calculations in high energy physics using the interactive theorem prover Lean 4. HepLean is an open-source project to digitalise definitions, theorems, proofs, and calculations in physics using the interactive theorem prover Lean 4.
HepLean has the potential to benefit the high energy physics community in four ways: ## Scope of HepLean
Currently the scope of HepLean includes the results and foundations of the following arXiv categories:
*hep-th, hep-ph, hep-ex, hep-lat, gr-qc, and math-ph.*
In particular, the current scope of HepLean includes (but is not limited to) the following foundational areas:
*special and general relativity, quantum mechanics, quantum field theory, particle physics, classical mechanics and field theory, cosmology, thermodynamics*
Once the foundations are in place, and HepLean has a large enough active community behind it, the scope of HepLean will naturally increase to include other areas of physics (and it most likely will undergo a name change).
# Why formalize physics?
HepLean has the potential to benefit the physics community in four ways:
- Make it easier to find results. - Make it easier to find results.
- Make it easier to automate the creation of new results using e.g. machine learning methods. - Make it easier to automate the creation of new results using e.g. machine learning methods.
- Make it easier to check papers and results for mathematical correctness. - Make it easier to check papers and results for mathematical correctness.
- Create new avenues through which high energy physics can be taught. - Create new avenues through which physics can be taught.
- Opens up new ways to interface between theory and computer programs.
HepLean is a connection between high energy physics (both formal and phenomenological),
computer science, and mathematics.
# How to get involved? # How to get involved?