Skip to content

docs(readme): modularize setup docs across root, backend, and frontend - #312

Merged
DenizAltunkapan merged 3 commits into
Vault-Web:mainfrom
shardool-patil:docs/readme-structure
Aug 6, 2026
Merged

docs(readme): modularize setup docs across root, backend, and frontend#312
DenizAltunkapan merged 3 commits into
Vault-Web:mainfrom
shardool-patil:docs/readme-structure

Conversation

@shardool-patil

Copy link
Copy Markdown
Contributor

Summary

Restructured repository documentation by modularizing setup instructions and moving module-specific details out of the root README.md into dedicated backend and frontend documentation:

  • Root README.md: Converted into a high-level entry point containing an ecosystem overview, module/dependency links, quickstart guide, and troubleshooting resources. Removed duplicated module configuration details.
  • backend/README.md: Documented module responsibilities, standalone execution instructions, unit testing commands, package structure, HTTP/HTTPS dev modes, and timezone troubleshooting notes.
  • frontend/README.md: Stripped out generic Angular CLI boilerplate while preserving Vault Web runtime configuration (runtime-config.local.js and forwardVaultWebToken handoff). Integrated HTTP/HTTPS dev server modes, unit testing steps, and directory structure layout.

Linked issue

Closes #310

How to test

  1. Open the root README.md and verify that high-level links, quickstart commands, and ecosystem descriptions render cleanly.
  2. Navigate to backend/ and check backend/README.md to ensure all standalone backend setup steps, HTTP/HTTPS modes, and testing instructions are clear and accurate.
  3. Navigate to frontend/ and check frontend/README.md to confirm that Angular CLI boilerplate is removed and runtime configuration / dev server modes are accurately documented.
  4. Verify that no duplicate setup instructions exist across the root and sub-module READMEs.

Notes / Risk

  • Documentation-only change: No application code, database migrations, or infrastructure configurations were modified. Zero operational risk.

@DenizAltunkapan

Copy link
Copy Markdown
Member

@shardool-patil please fix the failing workflows

@shardool-patil

Copy link
Copy Markdown
Contributor Author

@DenizAltunkapan I have fixed the failing workflows, just take a look.

@DenizAltunkapan DenizAltunkapan left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

@shardool-patil Three small fixes, all in frontend/README.md.
Lines 64, 66 and 109 — backticks were dropped around public/runtime-config.local.js and dist/; they were code-formatted before.
Fix those and I'll approve.

Comment thread frontend/README.md Outdated
Comment thread frontend/README.md Outdated

@DenizAltunkapan DenizAltunkapan left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

@shardool-patil thank you for your contribution

@DenizAltunkapan
DenizAltunkapan merged commit 2b3b200 into Vault-Web:main Aug 6, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: slim down root README and add per-module READMEs

2 participants