Skip to content

Commit

Permalink
README.md: updated for a more marketable tone.
Browse files Browse the repository at this point in the history
The current README.md is quite broken. Since we are still in
prototyping stage, we can proceed to upgrade it incrementally.
Hence, let's iterate it changes here first.

This patch updates README.md for a more marketable tone.

Co-authored-by: Shuralyov, Jean <[email protected]>
Co-authored-by: Galyna, Cory <[email protected]>
Co-authored-by: (Holloway) Chew, Kean Ho <[email protected]>
Signed-off-by: (Holloway) Chew, Kean Ho <[email protected]>
  • Loading branch information
3 people committed Jun 7, 2024
1 parent d6e0bbe commit 8145070
Showing 1 changed file with 25 additions and 16 deletions.
41 changes: 25 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,11 @@
# Hestia Libraries - `hestiaERROR`

[![Hestia Libraries](.src/icons/banner_1200x270.svg)](#)
[![Hestia Libraries](/src/icons/banner_1200x270.svg)](#)

One Peaceful Frontend+Backend Software Library Suite.

This repository houses the operating components of the error code numbering
definitions and representations for various supported programming languages. The
repository splits itself into multiple parts depending on its language-specific
or deployment-specific usage.
This repository facilitates error numbering definitions for error reporting in
memory constrained environment.



Expand All @@ -20,13 +18,12 @@ This project was initiated primarily because of:
making sure the `hestiaERROR` library talks to each other seamlessly across
programming languages with the same context.
2. **Utilizing low memory, language-free, and simple error reporting** -
using simple 1 byte number across the projects and software layers for
highest efficiency and works as a signal.
3. **Keeping string representations within the project's language
internationalization libraries** - making string processing and translations
a lot more simple to manage and operate.
4. **Simple to integrate** - simple enough to use the supported programming
language's package manager.
using simple 1 byte number across all technologies and software layers for
highest signal consistencies.
3. **Keeping string error representations internationalization capable** -
making string translations a lot easier to manage.
5. **Simple to integrate** - simple enough to use for all supported programming
languages.



Expand All @@ -43,6 +40,13 @@ language:


### Javascript Ecosystems

#### Git Release Branches (Recommended)

#### NPM



## Data Source

Expand All @@ -54,7 +58,7 @@ The libraries are based on the following data sources:
1. Source: `include/uapi/asm-generic/errno.h`
3. Linux Kernel - Extended Error Numbers
1. Source: `include/linux/errno.h`
4. BASH Exit Status list
4. BASH Exit Statuses
1. Source: https://tldp.org/LDP/abs/html/exitcodes.html
5. PowerShell Error Handling
1. Source: https://learn.microsoft.com/en-us/powershell/scripting/learn/deep-dives/everything-about-exceptions
Expand All @@ -63,6 +67,11 @@ These sources are strongly referencing from the Linux Kernel while maintaining
the definitions usable even at operating system scripting level for both UNIX
and Windows OSes.




## Design Principles

The definitions complies to only the following rules:

1. **STRICTLY**: **`0` represents OK**.
Expand All @@ -71,9 +80,9 @@ The definitions complies to only the following rules:
differently).
4. Avoid redefining existing codes (can but frown upon).

Based on years of programming experiences across multiple languages, these error
codes are newly defined and each software layers can redefine the list whenever
needed for independent packaging purposes.
Based on years of programming experiences across multiple programming languages,
each software layer or project can redefine the list whenever needed
for independent packaging purposes as long as the rules' above are complied.



Expand Down

0 comments on commit 8145070

Please sign in to comment.