agaric/documentation
10
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
documentation/tools/git-agaric-com-forgejo.md

2.2 KiB
Raw Blame History

git.agaric.com's Forgejo

Create an organization for each client (Forgejo does not support sub-groups).

  • https://git.agaric.com/org/create
    • Organization name should be what you want in the URL— all lowercase, with dashes instead of any spaces (an "Organization full name" can be set in the organization settings later).
    • Visibility should be either Public or Private ("Limited" makes no sense for Agaric's diverse clients and initiatives).
      • For Drutopia and some other clients, the organization made for them should be public.
    • Leave "Repository admin can add and remove access for teams" checked.

After it is created, press the View example-org button in the upper right of the screen. From here you can press settings to add a logo, full name, and description.

Then migrate or make a new repository project (New migration or New repository buttons).

  • For migrating:
    • Get an API access token from GitLab or GitHub to be able to import issues etc.
    • Be sure to uncheck "This repository will be a mirror" generally.
    • Be sure to check off what you want to migrate in addition to the code.
  • Visibility can have "Make repository private" left unchecked to keep it public. In this case it is worth noting why in the Description, for example "As a Drutopia project we hope others can learn from and emulate, this project is public."

User account creation and adding people to a project

As of now, do not invite users by e-mail address directly from a Team tab but instead:

  1. Create user at https://git.agaric.com/admin/users/new
  2. Return to the team tab for the organization (org/example-organization/teams
  3. Click into ('View') the 'Owners' team /org/example-organization/teams/owners (or create) the team named after the client (so /org/example-organization/teams/example)
  4. Use the search user bar to find that user account and then—only if it autocompletes and you select the user—the "Add Team Member" button.

Side notes

  • Leave the setting for User visibility to Private.
  • Leave Allow Creation of Organizations by Default disabled.
  • (The 'Add Team Member' button used to be green, now it is red, why Forgejo why.)