Skip to content

Conversation

@xrissoula
Copy link
Contributor

Description

This PR adds eight new reference documents and updates the sidebar to include them under the “Architecture” section of the “Reference” category.

Additionally, the documents have been formatted and linted to comply with repository standards.
Changes

New Documents Added:

  • docs/reference/DES.md
  • docs/reference/ecis.md
  • docs/reference/encryption-algorithms.md
  • docs/reference/hybrid-cryptosystem.md
  • docs/reference/json-webx-standards.md
  • docs/reference/kem.md
  • docs/reference/key-encryption-management-storage.md
  • docs/reference/node-id.md

Sidebar Update:

  • The above documents were added under Reference > Architecture in sidebars.ts

Reason for Changes

  • These documents are necessary for expanding the reference section with additional encryption-related documentation.
  • The sidebar update ensures they are accessible in the documentation UI.
  • The previous versions of these documents were not correctly formatted, so this update includes lint fixes and formatting corrections.

Previous PR Context

  • These documents have been part of earlier discussions and were initially added without full linting compliance.
  • This PR ensures they adhere to markdownlint standards while also making them visible in the Docusaurus sidebar.

Testing

  • The Docusaurus local server (npm run start) was used to verify that the documents render correctly and are properly linked in the sidebar.

Issues Fixed

Tasks

  • 1. Format and lint the eight reference documents
  • 2. Ensure proper Docusaurus rendering for new documents
  • 3. Update sidebars.ts to include new documents under Reference > Architecture
  • 4. Verify sidebar updates reflect correctly in local Docusaurus build
  • 5. Commit changes using feat: in conventional commits
  • 6. Push changes and open PR

Final checklist

  • Domain specific tests
  • Full tests
  • Updated inline-comment documentation
  • Lint fixed
  • Squash and rebased
  • Sanity check the final build

@xrissoula xrissoula force-pushed the docs/update-reference branch from d19bebf to 79c9cfd Compare March 18, 2025 22:05
@CMCDragonkai
Copy link
Member

Wrong branch name @xrissoula .

@xrissoula
Copy link
Contributor Author

closed in favor of PR #136

@xrissoula xrissoula closed this Mar 20, 2025
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

Development

Successfully merging this pull request may close these issues.

3 participants