From 73f85b4b8d240fa930ff04c102c4a5c08df267fc Mon Sep 17 00:00:00 2001 From: James Bayley <36523314+jamesbayley@users.noreply.github.com> Date: Thu, 15 Feb 2024 09:10:31 +0000 Subject: [PATCH] Update README --- README.md | 63 ++++++++++++++++++++++++++++++++++++++++++++++++------- 1 file changed, 55 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 79630ff..c4537d3 100644 --- a/README.md +++ b/README.md @@ -9,35 +9,82 @@ [![CI](https://github.com/GazelleKit/gazelle/actions/workflows/ci.yml/badge.svg)](https://github.com/GazelleKit/gazelle/actions/workflows/build.yml) [![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blueviolet)](https://choosealicense.com/licenses/agpl-3.0/) - [![Go](https://img.shields.io/badge/Go-1.21-00add8)](https://go.dev/) + [![Go](https://img.shields.io/badge/Go-1.22-00add8)](https://go.dev/) ## Table of Contents -- [Table of Contents](#table-of-contents) - [Overview](#overview) +- [Getting Started](#getting-started) +- [The Gazelle CLI](#the-gazelle-cli) - [Open Source](#open-source) - [Contributing](#contributing) +- [Community](#community) - [Errata](#errata) ## Overview -Gazelle is a fast, efficient and lightweight toolkit for Structural Engineers. It favours radical simplicity and loosely follows the Unix Philosophy. Gazelle offers a truly cross-platform alternative to traditional engineering software. +
+ Gazelle is a fast, efficient and lightweight engine for structural analysis and design. The project aspires to accelerate AEC software innovation, underpin academic research and support Structural Engineering education. Gazelle favours radical simplicity, loosely follows the Unix Philosophy, and offers a truly cross-platform alternative to traditional engineering software. +
> One who takes the road less traveled earns the rewards most missed. - Matshona Dhliwayo +## Getting Started + +
+ Gazelle is a daemon service that can run both locally and remotely. It adopts a typical, language-agnostic, client-server architecture by exposing its API over HTTP. This pattern was inspired by Docker (specifically dockerd
).
+
+ An official Gazelle CLI will be supported. More details to follow. +
+ ## Open Source -Engineers accept phenomenal responsibility when dedicating their lives to improve our built environment. However, the vast majority of professional engineering software is, regrettably, closed source and proprietary. This is unfair and must change. Engineers should be offered the respect and freedom to inspect, validate and influence the algorithms used to design our buildings and bridges. ++ Engineers accept phenomenal responsibility when dedicating their lives to improve our built environment. However, the vast majority of professional engineering software is, regrettably, closed source and proprietary. This is unfair and must change. Engineers should be offered the respect and freedom to inspect, validate and influence the algorithms used to design our buildings and bridges. +
-Gazelle is proudly open-source. ++ Gazelle is proudly open-source. +
## Contributing -For those interested in helping to build Gazelle, details will be provided in due course. Please ⭐️ and 'watch' this repository, so that you can track its progress in real-time. ++ For those interested in helping to build Gazelle, please ⭐️ and 'watch' this repository so that you can track its progress in real-time. +
+ ++ We are always on the lookout for new contributors to help: +
+ +- Propose design improvements, +- Develop and maintain the engine, +- Enhance our testing and performance suite, +- Verify algorithmic correctness. + +## Community + ++ For those keen to build upon the core Gazelle engine and extend its reach and capabilities, here are a few suggested project ideas: +
+ +- Create a dedicated Graphical User Interface (GUI) atop the HTTP API, +- Develop bespoke plugins so that other software can benefit from Gazelle, +- Organise local meetups to discuss how Gazelle could enhance your existing workflows, +- Plan conferences and community engagement events to broaden Gazelle's adoption, +- For Go developers, consider importing Gazelle as a package into your own projects. ## Errata -Gazelle aspires to achieve the highest standards of professional rigour. We consider Structural Analysis & Design software to be _safety critical_. We strive to ensure stability, robustness and correctness throughout the source code, test suite and companion documentation. Nevertheless, our team are human and mistakes _are_ possible. ++ Gazelle aspires to achieve the highest standards of professional rigour. We consider Structural Analysis & Design software to be safety critical. We strive to ensure stability, robustness and correctness throughout the source code, test suite and companion documentation. Nevertheless, our team are human and mistakes are possible. +
-We recommend that all users carefully review the code, tests and documentation. Please submit error reports and suggestions for improvement via [GitHub Issues](https://github.com/calcpadstudio/gazelle/issues). For anyone who would like to attempt a fix or improvement, we would encourage you to review our [Contributing](#contributing) guidance and submit a Pull Request. ++ We recommend that all users carefully review the code, tests and documentation. Please submit error reports and suggestions for improvement via GitHub Issues. For anyone who would like to attempt a fix or improvement, we would encourage you to review our Contributing guidance and submit a Pull Request. +