Repository navigation
Conversation
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.
medvednikov
left a comment
There was a problem hiding this comment.
Thanks for separating verified, missing, and not-verified capabilities. A few entries need tightening before this is relied on as a factual parity matrix: (1) Low RAM / CPU usage is marked implemented/verified solely on V, single binary, which is not evidence for actual resource consumption; mark it unverified or add measurements. (2) Multiple reviewers is ? not verified inside Implemented and verified, and ? is absent from the legend; move it to Not verified. (3) Telemetry says Gitly has absolutely none, whereas the repository implements telemetry ingestion and storage (platform_operations_routes.v/platform_operations.v). If the intended claim is no outbound usage tracking/phone-home, say that specifically and distinguish it from the product telemetry feature. These changes would make the matrix more trustworthy without changing the scope.
|
Done - addressed in the latest push. |
Summary
Adds a Gitea parity analysis, which the repository did not have anywhere. Gitly compares itself to GitHub and GitLab, but Gitea is the more useful bar: open source, single-node, same problem, same scale. Issue #142 asks for a Gitea row on the gitly.org comparison tab, and this is the factual basis anyone would need before writing one.
The source of truth is Gitea's own matrix, https://docs.gitea.com/installation/comparison, version 28. Gitea's caveat is carried into the document so readers know the bar moves:
Evidence
Rather than restate the README's claims, every row marked implemented was checked against source in this tree and cited as
file:line. Two examples:Two findings are worse than plain gaps, because a settings screen implies the feature is one click away:
Wiki has a setting and no feature.
update_repo_featurespersists the toggle, but a repository-wide search forwikifinds no wiki content model, no wiki route, and no wiki template. An owner can switch it on and find nothing.Topics is a counter.
repo/repo.v:23declaresnr_topics int @[skip],repo/repo_template.v:87formats it, but no route assigns topics, so the explore page shows a number that is always zero:The document separates 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 a final Not verified section. That last section exists deliberately: rows I could not check are listed rather than guessed, so an unexamined row is never mistaken for a negative one. It currently holds multiple PR reviewers, the topic UI surface, the batch-issue UI, and git hook extensibility.
Merge Danger
Door: Two-way. Documentation only; no product code, schema, or data. Reverting removes a file and one README sentence.
Blast Radius: None at runtime. The risk is reputational rather than technical: this document states Gitly does not have features the README currently implies, including the two stubs above. That is accurate and was verified, but it is a claim about the project's completeness, so it is the kind of change a maintainer may want to soften rather than have land cold.
The list of missing features is ordered by dependency, which means the first four items (wiki, topics, in-repo code search, comment reactions) are the cheap ones. It does not estimate effort, and it does not commit to any of it — it is a work queue, not a roadmap.