Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
d581288
Add documentation consolidation analysis and recommendations
claude Nov 12, 2025
3487a7e
Merge remote-tracking branch 'origin/main' into claude/consolidate-do…
claude Nov 15, 2025
88c9bea
Consolidate documentation research into single actionable guide
claude Nov 15, 2025
97613a3
Merge remote-tracking branch 'origin/main' into claude/consolidate-do…
claude Nov 16, 2025
7b85810
Update documentation plan based on November 2024 improvements
claude Nov 16, 2025
9ef6362
Add documentation-improvement-recommendations.md to research index
claude Nov 16, 2025
014fc9a
Update docs-site/docs/development/research/documentation-improvement-…
IsmaelMartinez Nov 16, 2025
5ad135e
Fix relative paths to module READMEs in Module Index example
claude Nov 16, 2025
11bca02
Fix relative path to CLAUDE.md in frontmatter and references
claude Nov 16, 2025
eba273c
Fix broken CLAUDE.md link for Docusaurus build
claude Nov 16, 2025
3d6f255
Fix broken directory links for Docusaurus build
claude Nov 16, 2025
fb8f213
Fix incomplete markdown syntax in Configure Multiple Instances section
claude Nov 17, 2025
d66c85c
Remove redundant research files superseded by ADRs
claude Nov 17, 2025
39137dc
Update Module Index to use GitHub repository links
claude Nov 17, 2025
3e93ead
Update sidebars.ts to remove deleted research files
claude Nov 17, 2025
e2ceb28
Fix broken links to deleted research files
claude Nov 17, 2025
b511fee
Fix incorrect multiple instances commands in Quick Reference example
claude Nov 17, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs-site/docs/development/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,8 @@ This directory contains technical documentation for Teams for Linux developers a
- **[token-cache-architecture.md](token-cache-architecture.md)** - Token cache implementation, secure storage architecture, and authentication persistence
- **[dom-access-investigation.md](research/dom-access-investigation.md)** - Research and findings on DOM access requirements, React breaking changes, and API feasibility
- **[security-architecture.md](security-architecture.md)** - Security architecture, threat model, and compensating controls documentation
- **[secure-storage-research.md](research/secure-storage-research.md)** - Research on secure storage options and implementation considerations
- **[token-cache-authentication-research.md](research/token-cache-authentication-research.md)** - Comprehensive research from problem analysis through implementation validation
- **[ADR-002: Token Cache Secure Storage](adr/002-token-cache-secure-storage.md)** - Architecture decision for secure token storage implementation
- **[ADR-003: Token Refresh Implementation](adr/003-token-refresh-implementation.md)** - Architecture decision for authentication persistence

## For Contributors

Expand Down
8 changes: 5 additions & 3 deletions docs-site/docs/development/research/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,8 @@ These documents capture in-depth analysis and strategic insights that inform dev
## Contents

### Authentication & Security Research
- **[Token Cache Authentication Research](token-cache-authentication-research.md)** - Comprehensive research from problem analysis through implementation and validation of token cache authentication solution (#1357)
- **[Secure Storage Research](secure-storage-research.md)** - Research on secure storage options, platform capabilities, and implementation considerations
- **[DOM Access Investigation](dom-access-investigation.md)** - Research and findings on DOM access requirements, React breaking changes, and API feasibility
- For implemented authentication solutions, see [ADR-002: Token Cache Secure Storage](../adr/002-token-cache-secure-storage.md) and [ADR-003: Token Refresh Implementation](../adr/003-token-refresh-implementation.md)

### Testing & Development Research
- **[Automated Testing Strategy](automated-testing-strategy.md)** - Comprehensive analysis of testing frameworks for Electron apps with MS authentication constraints
Expand All @@ -28,7 +27,10 @@ These documents capture in-depth analysis and strategic insights that inform dev
- Platform compatibility matrix and reasoning

### Strategic Analysis
- **[Documentation Health Analysis](documentation-health-analysis.md)** - Comprehensive assessment of documentation structure, quality, and maintainability
- **[Documentation Improvement Recommendations](documentation-improvement-recommendations.md)** - Actionable plan for optimizing documentation for both LLM and human consumption
- Based on expert reviews from 3 specialized perspectives
- Week 1 implementation (12-15 hours): Quick Reference, Module Index, ADR Index
- 80% value with 60% less effort than comprehensive overhaul
- **[UI System Strategic Analysis](ui-system-strategic-analysis.md)** - Strategic evaluation of the in-app UI system proposal and its alignment with project goals

### Architecture & Refactoring
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -1053,7 +1053,8 @@ class TeamsIntegrationDomain {
### Internal Documentation
- [IPC API Documentation](../ipc-api.md)
- [DOM Access Investigation](./dom-access-investigation.md)
- [Token Cache Authentication Research](./token-cache-authentication-research.md)
- [ADR-002: Token Cache Secure Storage](../adr/002-token-cache-secure-storage.md)
- [ADR-003: Token Refresh Implementation](../adr/003-token-refresh-implementation.md)
- [Automated Testing Strategy](./automated-testing-strategy.md)

### External Resources
Expand Down
168 changes: 0 additions & 168 deletions docs-site/docs/development/research/documentation-health-analysis.md

This file was deleted.

Loading
Loading