gitoria

6.2 KB

1. # Decisions — gitoria.worldapi.org
3. <!-- generated by the antcolony librarian (antcolony-scheduler: ./colony librarian) from librarian/decisions.json — do not edit by hand, it is rewritten -->
5. The creator's decisions for **gitoria.worldapi.org** — current state only (superseded ones: `DECISIONS-archive.md` beside this file).
6. **A decision here overrides anything else; ask only if it is not decided here.**
7. Each entry: date · the creator's exact words in quotes · where it was said · "means" = a READING (the librarian's or the architect's), not the creator's words — when in doubt, the quote counts.
9. ## Contents
10. - [differ component](#differ-component) — 3
11. - [git backend](#git-backend) — 1
12. - [gitoria concept](#gitoria-concept) — 2
13. - [pull requests](#pull-requests) — 1
15. ## differ component
17. - 2026-09-24 · **"this asks a question the original ticket #2 already answered"** · [gitoria.worldapi.org #3 — Question: where does the differ live?](https://tickets.worldapi.org/projects/gitoria.worldapi.org/3)
18. - means (the librarian's reading, not the creator's words): The question on where the differ lives is rejected: gitoria#2 already answers it. Follow #2 (reusable editor and differ Hybriel components in layouts.worldapi.org) and don't ask this again.
19. - 2026-09-24 · **"this is a question the original ticket description already answered"** · [gitoria.worldapi.org #4 — Question: embed custom-ide's editor for now?](https://tickets.worldapi.org/projects/gitoria.worldapi.org/4)
20. - means (the librarian's reading, not the creator's words): The question is rejected because the original ticket already answers it. Follow the original differ ticket: make editor and differ reusable Hybriel components, rewriting codejar in Hybriel if simple. Don't ask this again.
21. - 2026-09-24 · **"Differ from custom-ide"** · **"Evaluate if we can reuse the differ from `ssh://loreana//media/STORAGE/custom-ide` and its sophisticated codejar adaptions as a code editor in general. probably we can make editor and differ a reusable hybriel component in worldapi layouts / components in general as codejar is quite simple and probably easyly rwritable in hybriel"** · [gitoria.worldapi.org #2 — Differ from custom-ide](https://tickets.worldapi.org/projects/gitoria.worldapi.org/2)
22. - means (the librarian's reading, not the creator's words): Evaluate reusing the differ and codejar adaptions from custom-ide on loreana as a general code editor; aim to make editor and differ reusable Hybriel components in layouts.worldapi.org, rewriting codejar in Hybriel if simple.
24. ## git backend
26. - 2026-09-24 · [gitoria.worldapi.org #5 — Research: how to use git](https://tickets.worldapi.org/projects/gitoria.worldapi.org/5) · the creator wrote:
27. > Research: how to use git
28. >
29. > With nodejs we just installed nodegitserver but we also saw it was only partly capable of what was needed. Do a research on the best way on how we can use git with hbriel. is there a gitlib we make a hl:git plugin with or do we just use the git biary?
30. > What do we need?
31. > The developer pulls and pushes from their cli. commits should be browseable like on github or gitlab. the dev can use ssh keys or the git http credentials if thats not deprecated by git itself. what other functions do we need from git to have a similar user experience like we know from given repo hubs?
32. - means (the librarian's reading, not the creator's words): Research how Gitoria uses git from Hybriel (hl:git plugin on a git lib vs. the git binary). Must support CLI pull/push, GitHub/GitLab-style commit browsing, SSH keys or HTTP credentials, and list other needed repo-hub features.
34. ## gitoria concept
36. - 2026-09-25 · **"i cant test this because there is no description how i get a repo in at the /code page"** · [gitoria.worldapi.org #8 — Repo homepage from README and $docs](https://tickets.worldapi.org/projects/gitoria.worldapi.org/8)
37. - means (the librarian's reading, not the creator's words): gitoria#8 was sent back because the creator can't test it: the test steps must explain how to get a repo in so the /code page shows something, and the creator must be able to do it.
38. - 2026-09-24 · [gitoria.worldapi.org #1 — Rebuild gitoria in Hybriel: git hosting](https://tickets.worldapi.org/projects/gitoria.worldapi.org/1) · the creator wrote:
39. > Wildcard url: *.gitoria.worldapi.org
40. > a new repo needs a slug for that thats unique in the hole system.
41. > a repos / shows the README.md parsed to html, if there is a $docs folder it renders all md files inside that folder as a homepage
42. >
43. > /code shows the current state of their main branch (can be switched in settings)
44. > /branch/xy shows entire branch at last comit
45. > /commit/xy shows entire project at that commit
46. > /tickets implements the ticketlist view of tickets.worldapi.org, the moment one ticket is created the project is created in tickets.worldapi.org - when a user loggs in to tickets.worldapi.org they see all tickets of a gitoria project like its a tickets project.
47. > /pulls commits starting with `|||PR ` create a pull request using the branch title the main target for PRS can be configured in settings and is main by default `|||PR|name-of-branch] ` at the beginning of a commit sets a target branch
48. > /releases a commit starting with `|||RL ` creates a semver release by default it counts up the last one 0.0.1 `|||RL|med ` counts up the middle number 0.1.0 and `|||RL|mj ` the major version 1.0.1 with `|||RL|1.1.1a ` the version can be set manually
49. - means (the librarian's reading, not the creator's words): Gitoria design: each repo gets a system-unique slug on *.gitoria.worldapi.org. / renders README.md (or $docs md files as homepage); /code, /branch/xy, /commit/xy views; /tickets mirrors tickets.worldapi.org; `|||PR` commits make pull requests; `|||RL` commits make semver releases.
51. ## pull requests
53. - 2026-09-25 · **"no, the final button click comes from the dev"** · [gitoria.worldapi.org #13 — Question (gitoria.worldapi.org#11): Should gitoria merge pull request…](https://tickets.worldapi.org/projects/gitoria.worldapi.org/13)
54. - means (the librarian's reading, not the creator's words): Gitoria does not merge pull requests itself (no Merge button); the dev does the final merge with git, and a request shows 'merged' once it is in the target.