When creating a Diffusion Repo, add helpful text to each field
Closed, ResolvedPublic
Actions

Assigned To

Authored By

	Ekubischta
	Feb 23 2024, 14:19

Description

The Create Repository form looks like the following

It would be helpful to describe the fields on this form a bit better. And even the basic rules

CALLSIGN
For instance, we should describe that "CALLSIGN" must be all upper case, no spaces, and is used to reference this repository in tasks, etc. (using the rXXXXX syntax)

Short Name
Note that the short name is used in URI's for the repo, and URI in Phorge to the repo

This would be helpful when setting up new repos.

The diviner doc is at https://we.phorge.it/book/phorge/article/diffusion_managing/

Revisions and Commits

rP Phorge
	D25898	rP5bd99a394aed Add instructions to Create Repository form fields for Callsign and Short Name

Related Objects

Mentioned Here: T15151: Allow to prefill the Diffusion creation form with Policies and preference on "Enormous changes"

Event Timeline

Ekubischta created this task.Feb 23 2024, 14:19

Herald added subscribers: Cigaryno, Matthew, chris, tobiaswiese. · View Herald TranscriptFeb 23 2024, 14:19

Ekubischta renamed this task from When creating a Diffusion Rep, add helpful text to each field to When creating a Diffusion Repo, add helpful text to each field.Feb 23 2024, 14:19

valerio.bozzolan added a project: UX.Dec 2 2024, 17:37

valerio.bozzolan subscribed.

For later



```lang=diff
diff --git a/src/applications/diffusion/editor/DiffusionRepositoryEditEngine.php b/src/applications/diffusion/editor/DiffusionRepositoryEditEngine.php
index c9dbb2b329..48fa22c12a 100644
--- a/src/applications/diffusion/editor/DiffusionRepositoryEditEngine.php
+++ b/src/applications/diffusion/editor/DiffusionRepositoryEditEngine.php
@@ -287,6 +287,7 @@ final class DiffusionRepositoryEditEngine
       id(new PhabricatorTextEditField())
         ->setKey('callsign')
         ->setLabel(pht('Callsign'))
+        ->setPlaceholder('SOME_UPPERCASE_NAME_NO_SPACES')
         ->setTransactionType(
           PhabricatorRepositoryCallsignTransaction::TRANSACTIONTYPE)
         ->setDescription(pht('The repository callsign.'))
@@ -296,6 +297,7 @@ final class DiffusionRepositoryEditEngine
       id(new PhabricatorTextEditField())
         ->setKey('shortName')
         ->setLabel(pht('Short Name'))
+        ->setPlaceholder('some-lowercase-name-no-spaces')
         ->setTransactionType(
           PhabricatorRepositorySlugTransaction::TRANSACTIONTYPE)
         ->setDescription(pht('Short, unique repository name.'))

Ekubischta added a revision: D25898: Add instructions to Create Repository form fields for Callsign and Short Name.Feb 26 2025, 23:19

Ekubischta closed this task as Resolved by committing rP5bd99a394aed: Add instructions to Create Repository form fields for Callsign and Short Name.Tue, Mar 11, 13:12

Ekubischta claimed this task.

Ekubischta added a commit: rP5bd99a394aed: Add instructions to Create Repository form fields for Callsign and Short Name.

When creating a Diffusion Repo, add helpful text to each fieldClosed, ResolvedPublicActions

Description

Revisions and Commits

Related Objects

Event Timeline

When creating a Diffusion Repo, add helpful text to each field
Closed, ResolvedPublic
Actions