Skip to content

docs: add roadmap to Gitea parity - #301

Open
metif12 wants to merge 3 commits into
vlang:masterfrom
metif12:docs/gitea-roadmap
Open

metif12 wants to merge 3 commits into
vlang:masterfrom
metif12:docs/gitea-roadmap

Conversation

@metif12

@metif12 metif12 commented Nov 10, 2026

Copy link
Copy Markdown
Member

Adds a phased roadmap. Companion to gitea-parity.md.

office and others added 3 commits October 13, 2026 10:44
Gitly compares itself to GitHub and GitLab, but there was no Gitea
comparison anywhere in the repository, and Gitea is the more useful bar: it is
open source, single-node, and solves the same problem at the same scale.
Issue vlang#142 asks for a Gitea row on the gitly.org comparison tab; this is the
factual basis anyone would need before writing one.

The source of truth is Gitea's own matrix at
https://docs.gitea.com/installation/comparison, checked against Gitea docs
version 28. Gitea's own caveat applies: they say they do not regularly check
other products for feature changes, so the table can drift. That caveat is
carried into the document so a reader knows the bar moves.

Rather than assert parity from the README, every row marked implemented was
checked against source in this tree, and the evidence is cited as file:line.
Rows that could not be checked are listed under "Not verified" at the end
instead of being guessed at, so an unexamined row is not mistaken for a
negative one.

Two findings worth calling out, because they are worse than plain gaps:

- Wiki has a setting and no feature. `repo/repo.v:49` declares `disable_wiki`,
  `repo/repo.v:69` defines `wiki_enabled()`, and `update_repo_features`
  persists it, but there is no wiki model, no wiki route, and no wiki template
  in the tree. A repository owner can switch it on and find nothing.
- Topics is a counter. `repo/repo.v:23` declares `nr_topics` and
  `repo/repo_template.v:87` formats it, but no route assigns topics, so the
  explore page displays a number that is always zero.

Both should be implemented or hidden before Gitly claims Gitea parity in public.

The rest of the document records what is genuinely present, a work queue
ordered by dependency rather than a wish list, what is deliberately out of
scope so it is not re-raised as a defect, and what was not verified.

The bar is Gitea's feature matrix, not everything Gitea can do. GitLab stays
tracked in docs/gitlab-parity.md and this does not replace it.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant