update

crates/workspace/src/views/sidebar/create_repo_dialog.rs

@@ -24,10 +24,9 @@ pub struct CreateRepoState {
 }
 
 /// Open the Create Repository dialog.
-///
-/// The dialog loads the user's default grasp servers (kind `10317` grasp
-/// list) and falls back to the shared defaults when none are set. On
-/// success the dialog closes and the new repository opens in the dock.
+/// Loads the user's default grasp servers, a kind `10317` grasp list.
+/// Falls back to the shared defaults when none are set.
+/// On success the dialog closes and the new repository opens in the dock.
 pub fn open(dock_area: WeakEntity<DockArea>, window: &mut Window, cx: &mut App) {
     let settings = SettingsStore::global(cx);
     let default_folder = settings
@@ -160,10 +159,9 @@ pub fn open(dock_area: WeakEntity<DockArea>, window: &mut Window, cx: &mut App)
     });
 }
 
-/// Prompt the user to pick the folder the repository will be stored in, using
-/// the platform's native folder picker, and show the result in the disabled
-/// folder input. The picked folder is remembered in the settings so it
-/// becomes the default next time.
+/// Pick the repository's storage folder with the platform's native folder picker.
+/// Show the result in the disabled folder input.
+/// The settings remember the picked folder as the default next time.
 fn choose_folder(folder_input: &Entity<InputState>, window: &mut Window, cx: &mut App) {
     let handle = window.window_handle();
     let folder_input = folder_input.clone();
@@ -198,8 +196,8 @@ fn choose_folder(folder_input: &Entity<InputState>, window: &mut Window, cx: &mu
     .detach();
 }
 
-/// Run the create-repository flow,
-/// opens the new working copy and the repository panel on success.
+/// Run the create-repository flow.
+/// Opens the new working copy and the repository panel on success.
 #[allow(clippy::too_many_arguments)]
 fn create_repository(
     name_input: Entity<InputState>,
@@ -247,8 +245,8 @@ fn create_repository(
         Ok((announcement, local_path)) => {
             cx.update_window(handle, |_, window, cx| {
                 window.close_dialog(cx);
-                // Remember the new working copy as a checkout of this
-                // repository, so the New PR panel pre-fills it.
+                // Record the new working copy as a checkout of this repository.
+                // The New PR panel then pre-fills it.
                 let checkouts = CheckoutsStore::global(cx);
                 checkouts.update(cx, |store, cx| {
                     store.record(local_path.clone(), announcement.addr(), cx);