Skip to content

doc: update README for improved clarity and formatting#36

Open
SymonMuchemi wants to merge 1 commit into
developfrom
docs/new_features
Open

doc: update README for improved clarity and formatting#36
SymonMuchemi wants to merge 1 commit into
developfrom
docs/new_features

Conversation

@SymonMuchemi

Copy link
Copy Markdown

This pull request updates the README.md to provide a clearer and more comprehensive overview of the URY system and its features. The changes improve formatting, add new feature descriptions, and clarify legacy app support details to help users better understand the product and its capabilities.

Feature Documentation Improvements:

  • Expanded the POS & Billing section to include new features such as automatic customer selection, mandatory invoice printing before payment, improved branch-level stock validation, real-time stock feedback, and refined BOM handling for QSR items.
  • Enhanced the Kitchen Display & KOT Management section with new features like auto-completion of work orders and better KOT syncing.

Formatting and Clarity:

  • Reformatted feature lists from markdown asterisks to dashes for consistency and readability.
  • Improved the presentation of legacy app support notes by merging lines and clarifying the end-of-support date for previous app versions.

General Documentation Updates:

  • Updated the introduction and warning section to better communicate the active development status and stability expectations.
  • Added a pointer to the comprehensive feature list in FEATURES.md for users seeking more details.

- Removed unnecessary line breaks for better readability.
- Standardized warning and note formatting for consistency.
- Enhanced feature list presentation by aligning bullet points.
- Clarified instructions regarding the use of the URY branch `v1` for accessing previous app versions.
- Improved overall structure and flow of the README content to facilitate easier navigation and understanding.
@SymonMuchemi SymonMuchemi self-assigned this Oct 24, 2025
@SymonMuchemi SymonMuchemi added the documentation Improvements or additions to documentation label Oct 24, 2025
Comment thread README.md
- Modern, fast UI with guided flow
- Shift opening, closing, and cash reconciliation built-in
- Automatic default customer selection when a POS is loaded
- New setting to mandate printing an invoice prior to accepting payment

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

#8

Comment thread README.md
- Advanced filters for order and bill management
- Modern, fast UI with guided flow
- Shift opening, closing, and cash reconciliation built-in
- Automatic default customer selection when a POS is loaded

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

#2

Comment thread README.md
- Shift opening, closing, and cash reconciliation built-in
- Automatic default customer selection when a POS is loaded
- New setting to mandate printing an invoice prior to accepting payment
- Restaurants with multiple branches (one company, many warehouses) can now validate raw material availability per branch correctly.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

#10

Comment thread README.md
- Automatic default customer selection when a POS is loaded
- New setting to mandate printing an invoice prior to accepting payment
- Restaurants with multiple branches (one company, many warehouses) can now validate raw material availability per branch correctly.
- Prevents POS from confirming orders when required raw materials are insufficient.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

#10

Comment thread README.md
- New setting to mandate printing an invoice prior to accepting payment
- Restaurants with multiple branches (one company, many warehouses) can now validate raw material availability per branch correctly.
- Prevents POS from confirming orders when required raw materials are insufficient.
- Split stock validation: QSR items validate raw materials at order placement via BOM; at submission skip raw-material checks to avoid double-validation, while non-QSR use standard ERPNext checks.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

#12

Comment thread README.md
- Restaurants with multiple branches (one company, many warehouses) can now validate raw material availability per branch correctly.
- Prevents POS from confirming orders when required raw materials are insufficient.
- Split stock validation: QSR items validate raw materials at order placement via BOM; at submission skip raw-material checks to avoid double-validation, while non-QSR use standard ERPNext checks.
- Added skip_raw_material_validation on POS Invoice — validates BOM raw materials only when the invoice is Draft, auto-sets the flag after successful validation to avoid duplicate checks, and skips raw-material validation on submission (falls back to normal stock checks), preventing double-blocking while ensuring material sufficiency upfront.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

#13

Comment thread README.md
- Prevents POS from confirming orders when required raw materials are insufficient.
- Split stock validation: QSR items validate raw materials at order placement via BOM; at submission skip raw-material checks to avoid double-validation, while non-QSR use standard ERPNext checks.
- Added skip_raw_material_validation on POS Invoice — validates BOM raw materials only when the invoice is Draft, auto-sets the flag after successful validation to avoid duplicate checks, and skips raw-material validation on submission (falls back to normal stock checks), preventing double-blocking while ensuring material sufficiency upfront.
- Improved BOM handling for QSR (make-to-order) items: added get_all_leaf_bom_items() to expand nested BOMs into leaf components; QSR items without a BOM now halt and raise an error; component quantities are aggregated with correct precision to avoid floating‑point drift.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

#23

Comment thread README.md
- Split stock validation: QSR items validate raw materials at order placement via BOM; at submission skip raw-material checks to avoid double-validation, while non-QSR use standard ERPNext checks.
- Added skip_raw_material_validation on POS Invoice — validates BOM raw materials only when the invoice is Draft, auto-sets the flag after successful validation to avoid duplicate checks, and skips raw-material validation on submission (falls back to normal stock checks), preventing double-blocking while ensuring material sufficiency upfront.
- Improved BOM handling for QSR (make-to-order) items: added get_all_leaf_bom_items() to expand nested BOMs into leaf components; QSR items without a BOM now halt and raise an error; component quantities are aggregated with correct precision to avoid floating‑point drift.
- Disable the POS close action and update button feedback when summary data is missing to prevent incomplete closures and improve user clarity.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

#26

Comment thread README.md
- Added skip_raw_material_validation on POS Invoice — validates BOM raw materials only when the invoice is Draft, auto-sets the flag after successful validation to avoid duplicate checks, and skips raw-material validation on submission (falls back to normal stock checks), preventing double-blocking while ensuring material sufficiency upfront.
- Improved BOM handling for QSR (make-to-order) items: added get_all_leaf_bom_items() to expand nested BOMs into leaf components; QSR items without a BOM now halt and raise an error; component quantities are aggregated with correct precision to avoid floating‑point drift.
- Disable the POS close action and update button feedback when summary data is missing to prevent incomplete closures and improve user clarity.
- Real-time stock availability tracking directly into the POS menu, providing immediate visual feedback to the cashier and enabling the system to hide unavailable items based on configuration.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

#29

Comment thread README.md
- Delay, cancellation, and modification tracking
- Real-time kitchen analytics
- Seamless flow from order to service across stations
- Auto-complete work orders, create stock entries, and sync KOTs to Served on POS submission.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

#18

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant