Skip to content

fix: improvements for Learn and Develop sections#244

Merged
patextreme merged 21 commits intomainfrom
docs-improvements
Jan 19, 2026
Merged

fix: improvements for Learn and Develop sections#244
patextreme merged 21 commits intomainfrom
docs-improvements

Conversation

@patextreme
Copy link
Copy Markdown
Contributor

@patextreme patextreme commented Jan 15, 2026 •
edited
Loading

Summary

This PR restructures and enhances the Learn and Develop documentation sections, improving content organization and navigation clarity based on the Education Team's recommendations.

Changes

  • Learn Section - Renamed "Why Identity" → "About Hyperledger Identus", added comprehensive docs including "What is Hyperledger Identus" and "Basic concepts" covering identity fundamentals, features, multi-tenancy, and use cases
  • Advanced Explainers - Renamed "Components" → "Advanced explainers" with updated overview, added "Related Tutorials" sections linking to Develop section
  • Develop Section - Renamed "Developers" → "Develop" across navigation menu, configs, and all path references
  • Quick Start - Removed introductory content (identity basics, SSI principles) now available in Learn section for better separation of concerns
  • Path Updates - Updated folder structure documentation/developers → documentation/develop and migrated all internal cross-references

Screenshot

2026-01-16T18:41:45,993269578+07:00

Related Issue: #235 - Website Improvements

@patextreme patextreme changed the title fix: docs improvements on Learn and Develop sections fix: documentation improvements for Learn and Develop sections Jan 15, 2026
@patextreme
Update identity documentation heading
73067d3 
Signed-off-by: Pat Losoponkul <pat.losoponkul@iohk.io>
@patextreme
Make Introduction page visible in sidebar
efe2941 
Signed-off-by: Pat Losoponkul <pat.losoponkul@iohk.io>
@patextreme
Rename identity.md to about-hyperledger-identus.md
9c830ac 
Signed-off-by: Pat Losoponkul <pat.losoponkul@iohk.io>
@patextreme
Restructure learn section documentation
ecd2b93 
Signed-off-by: Pat Losoponkul <pat.losoponkul@iohk.io>
@patextreme
Restructure learn documentation with category-based navigation
b53c1aa 
Signed-off-by: Pat Losoponkul <pat.losoponkul@iohk.io>
@patextreme
Replace introduction with what-is-hyperledger-identus
8b3c5d8 
Signed-off-by: Pat Losoponkul <pat.losoponkul@iohk.io>
@patextreme
Add basic concepts documentation for Identus
6e3cebd 
Signed-off-by: Pat Losoponkul <pat.losoponkul@iohk.io>
@patextreme
Update image references in basic concepts documentation
50ca274 
Signed-off-by: Pat Losoponkul <pat.losoponkul@iohk.io>
@patextreme
Flatten documentation directory structure
472e351 
Signed-off-by: Pat Losoponkul <pat.losoponkul@iohk.io>
@patextreme
Remove introductory content from quick start guide
76688dc 
Signed-off-by: Pat Losoponkul <pat.losoponkul@iohk.io>
@patextreme
Change Developers menu label to Develop
907a8e8 
Signed-off-by: Pat Losoponkul <pat.losoponkul@iohk.io>
@patextreme
Rename components to advanced-explainers and update references
837c2e6 
Signed-off-by: Pat Losoponkul <pat.losoponkul@iohk.io>
@patextreme
Update Advanced explainers links and sidebar metadata
1af0d12 
Signed-off-by: Pat Losoponkul <pat.losoponkul@iohk.io>
@patextreme
Add tracking document for issue #235 leftovers
10d2a54 
Signed-off-by: Pat Losoponkul <pat.losoponkul@iohk.io>
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Jan 15, 2026 •
edited
Loading

🦙 MegaLinter status: ✅ SUCCESS

Descriptor Linter Files Fixed Errors Elapsed time

See detailed report in MegaLinter reports
Set VALIDATE_ALL_CODEBASE: true in mega-linter.yml to validate all sources, not only the diff

MegaLinter is graciously provided by OX Security

@patextreme
Update advanced explainers link paths
873449c 
Signed-off-by: Pat Losoponkul <pat.losoponkul@iohk.io>
@patextreme
Rename developers documentation folder to develop
40787de 
Signed-off-by: Pat Losoponkul <pat.losoponkul@iohk.io>
@patextreme
Add related tutorials sections to advanced explainer docs
c20a4bc 
Signed-off-by: Pat Losoponkul <pat.losoponkul@iohk.io>
@patextreme patextreme changed the title fix: documentation improvements for Learn and Develop sections fix: improvements for Learn and Develop sections Jan 16, 2026
@patextreme patextreme mentioned this pull request Jan 16, 2026
Open
25 tasks
@patextreme
Remove temporary leftovers documentation file
613410d 
Signed-off-by: Pat Losoponkul <pat.losoponkul@iohk.io>
@patextreme
Update self-sovereign identity links to internal documentation
9392e3b 
Signed-off-by: Pat Losoponkul <pat.losoponkul@iohk.io>
@patextreme patextreme marked this pull request as ready for review January 16, 2026 11:40
@patextreme patextreme requested a review from a team as a code owner January 16, 2026 11:40
FabioPinheiro
FabioPinheiro approved these changes Jan 19, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

@FabioPinheiro FabioPinheiro left a comment

Choose a reason for hiding this comment

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

LGTM

Comment thread documentation/learn/README.md
@patextreme patextreme merged commit eeb7570 into main Jan 19, 2026
5 checks passed
@patextreme patextreme deleted the docs-improvements branch January 19, 2026 12:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@FabioPinheiro FabioPinheiro FabioPinheiro approved these changes

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@patextreme @FabioPinheiro