ticketsLog in with ident

gitoria.worldapi.org #8

Repo homepage from README and $docs

review

opened by Architect · assigned to Caramboleyo

opened · updated

A repo's / shows its README.md as a page; with a $docs folder, all its Markdown files form the homepage.

Concept: gitoria's CONCEPT.md (your first thoughts, verbatim).

Part of gitoria.worldapi.org #1 Rebuild gitoria in Hybriel: git hosting open

History

  1. Architect opened the ticket
  2. AntColonyScheduler changed the state progress

    A worker started on this ticket.

    colony-lease: s-20260924T2101-713d6b · host Loreana · started · ms 1790290882585

  3. AntColonyScheduler commented

    Built — goes live with the next deploy.

    colony-report: s-20260924T2101-713d6b · sha256 7e39903804a0 · controller pass · ready to deploy

  4. AntColonyScheduler commented

    Now live on gitoria.worldapi.org — A repo's address now shows its README.md as a page, or all Markdown files of its $docs folder.

    Test:

    1. After the deploy, open a repo's address, e.g. https://<name>.gitoria.worldapi.org.
    2. A repo without files says it has no README.md yet.
    3. Once code is pushed (next ticket), README.md shows as a formatted page.
    4. With a $docs folder, its Markdown files replace the README.
    • Decided: Root README is not shown when $docs has Markdown files; $docs files are shown in path order, subfolders included; Homepage is read from the repo's HEAD; the branch setting comes with #9; Rep…
    • Not done: Repos created before this change have no bare git repo, so they show 'no README.md yet' u… (and 2 more)

    colony-deployed: s-20260924T2101-713d6b · sha256 7e39903804a0

  5. AntColonyScheduler changed the state review

    Ready for you to test — see the last comment.

  6. Caramboleyo changed the state open

    i cant test this because there is no description how i get a repo in at the /code page

  7. AntColonyScheduler changed the state progress

    A worker started on this ticket.

    colony-lease: s-20260925T1632-925ab0 · host Loreana · started · ms 1790361150723

  8. AntColonyScheduler commented

    Built — goes live with the next deploy.

    colony-report: s-20260925T1632-925ab0 · sha256 fe1c4716d3a1 · controller pass · ready to deploy

  9. AntColonyScheduler commented

    Now live on gitoria.worldapi.org — Empty repos now explain how to push code, with ready-to-copy git commands, on the Readme and Code pages.

    Test:

    1. Log in, create a repo, open its address: the box 'Add code to this repository' is open.
    2. Copy the 'Push a new project' commands into a terminal; use an access token as password.
    3. Reload the repo address: the README.md text is shown as a page.
    4. Open /code on the repo: the pushed files are listed.
    • Decided: Only appended a hint sentence to the existing empty messages; the box itself is unchanged.
    • Not done: The 'Add code' box only reaches the creator once the gitoria#7 work is deployed (HTTPS pu…

    colony-deployed: s-20260925T1632-925ab0 · sha256 fe1c4716d3a1

  10. AntColonyScheduler changed the state review

    Ready for you to test — see the last comment.

Reading is open to everyone. To comment or change the state, log in with ident (top right) and choose a display name.