MokoConsulting/MokoGitea-APP
1
0
Fork 0
Code Issues 158 Pull Requests 3 Releases 96 Wiki Activity

feat: native code documentation engine (auto-generated API docs) #131

New Issue
Open
opened 2026-05-21 17:27:33 +00:00 by jmiller · 0 comments
jmiller commented 2026-05-21 17:27:33 +00:00
Owner
Copy Link
Copy Source

Summary

Build a native code documentation engine that auto-generates browsable API docs from source code comments across all repos.

Priority: High

Core

  • Parse standard doc comments (Go godoc, JSDoc, PHPDoc, Python docstrings)
  • Auto-map functions, types, interfaces and relationships
  • Generate browsable HTML at /{owner}/{repo}/docs
  • Update on push to default branch
  • Cross-language: Go, TypeScript, PHP, Python

Features

  • Function/method index with search
  • Type hierarchy visualization
  • Cross-reference links
  • Source code click-through to file:line
  • Per-org documentation index
  • Doc coverage badge
  • Support MokoStandards FILE INFORMATION blocks

Implementation

  • Background job (like repo indexing)
  • Store parsed data in database
  • Integrate with bleve search
  • Consider tree-sitter for parsing

Authored-by: Claude Opus 4.6 (1M context)

## Summary Build a native code documentation engine that auto-generates browsable API docs from source code comments across all repos. ## Priority: High ### Core - Parse standard doc comments (Go godoc, JSDoc, PHPDoc, Python docstrings) - Auto-map functions, types, interfaces and relationships - Generate browsable HTML at /{owner}/{repo}/docs - Update on push to default branch - Cross-language: Go, TypeScript, PHP, Python ### Features - Function/method index with search - Type hierarchy visualization - Cross-reference links - Source code click-through to file:line - Per-org documentation index - Doc coverage badge - Support MokoStandards FILE INFORMATION blocks ### Implementation - Background job (like repo indexing) - Store parsed data in database - Integrate with bleve search - Consider tree-sitter for parsing *Authored-by: Claude Opus 4.6 (1M context)*
Sign in to join this conversation.
Labels
Clear labels
breaking-change
Breaking API or behavior change
 ci-cd
CI/CD pipeline changes
 config
Configuration changes
 dependencies
Dependency updates
 deploy-failure
Deployment failed
 docker
Docker/container changes
 documentation
Documentation changes
 good first issue
Good for newcomers
 health-check
Repo health check result
 help wanted
Extra attention needed
 mokostandards
Related to MokoStandards framework
 push-failure
Git push operation failed
 security
Security vulnerability or hardening
 size/l
200-500 lines changed
 size/m
50-200 lines changed
 size/s
10-50 lines changed
 size/xl
500+ lines changed
 size/xs
< 10 lines changed
 standards-drift
Deviates from MokoStandards
 standards-update
MokoStandards compliance update
 sync-failure
Sync or mirror failed
 tech-debt
Technical debt and TODO/FIXME items
 upstream
upstream
Inherited from upstream Gitea
 work-in-progress
Draft or incomplete work
No labels
Priority Medium
Type Feature
Milestone
No items
No Milestone
Assignees
Clear assignees
jmiller (Jonathan Miller) moko-deploy (Moko Deploy Bot)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: MokoConsulting/MokoGitea-APP#131
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?