MokoConsulting/MokoGitea
1
0
Fork 0
Code Issues 85 Pull Requests 1 Actions Packages Projects Releases 4 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)*
jmiller added the pending: design label 2026-05-22 02:01:08 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
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
 pending: testing
Feature implemented but not yet tested with documented proof
 priority: critical
Must fix immediately
 priority: high
Important, fix soon
 priority: low
Nice to have
 priority: medium
Normal priority
 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
 status: blocked
Blocked by dependency or decision
 status: in-progress
Actively being worked on
 status: needs-review
Awaiting code review
 status: on-hold
Paused intentionally
 status: wontfix
Will not be addressed
 sync-failure
Sync or mirror failed
 type: bug
Something isn't working
 type: bug
type: chore
Maintenance, dependencies, cleanup
 type: enhancement
Improvement to existing feature
 type: feature
New functionality
 type: refactor
Code restructuring without behavior change
 type: version
Version bump or release
 upstream
work-in-progress
Draft or incomplete work
bug
Something is not working
 chore
Maintenance and housekeeping
 documentation
Documentation improvements
 enhancement
Improvement to existing functionality
 feature
New feature or request
 pending: dependency
Blocked by another issue or external dependency
 pending: deployment
Tested and approved, awaiting deployment to production
 pending: design
Needs UI/UX or architecture design before implementation
 pending: documentation
Feature works, needs documentation/wiki update
 pending: feedback
Awaiting feedback or decision from stakeholder
 pending: review
Implementation complete, awaiting code review
 pending: testing
Feature implemented but not yet tested
 priority: critical
Must fix immediately
 priority: high
Should fix soon
 priority: low
Nice to have
 priority: medium
Fix when convenient
 refactor
Code restructuring without behavior change
 roadmap
Planned feature or enhancement tracked on the roadmap
 scope: client
Client-specific work
 scope: dolibarr
Dolibarr modules and customizations
 scope: infrastructure
Server, CI, backups, monitoring
 scope: joomla
Joomla templates and extensions
 scope: waas
MokoWaaS platform
 security
Security vulnerability or hardening
 status: blocked
Waiting on external dependency
 status: duplicate
Duplicate of another issue
 status: in-progress
Being worked on
 status: needs-review
Ready for review
 status: wontfix
Will not be addressed
No labels pending: design
Milestone
No items
No Milestone
Projects
Clear projects
No projects
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#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?