From 682df294f8b04f9a1861050c8f9f3444c647c52d Mon Sep 17 00:00:00 2001 From: Brian (bex) Exelbierd Date: Aug 30 2017 19:02:20 +0000 Subject: Adding procedure for listing files in a directory --- diff --git a/en-US/sysadmin_user_stories/procedure-listing_files_in_a_directory.adoc b/en-US/sysadmin_user_stories/procedure-listing_files_in_a_directory.adoc index 976fc39..3f423fb 100644 --- a/en-US/sysadmin_user_stories/procedure-listing_files_in_a_directory.adoc +++ b/en-US/sysadmin_user_stories/procedure-listing_files_in_a_directory.adoc @@ -1,48 +1,20 @@ // Include an 'ID' that corresponds to the title of the assembly // The ID will be used as an anchor for linking to the title // Do not change the ID to make sure existing links keep working -[#{assembly}-doing_one_procedure] -= Doing One Procedure +[#{assembly}-listing_files_in_a_directory] += Listing Files In A Directory -_Start the title with a verb form, such as Creating or Create._ - -_A procedure module is a procedure written with numbered steps -- what a user needs to do to accomplish a goal successfully._ - -// Ideally, base the name of the file on the title to avoid confusion -// Use a consistent system for filenames and IDs, e.g.: -// * Only substitute spaces with underscores -// * Don't use any CAPS - -This paragraph explains why the user performs the procedure, sets the context of the procedure, and may explain or list specical considerations specific to this procedure. Keep the information brief and focused on what is needed for this specific procedure. Suggested length is 1 to 3 sentences, can be longer if needed. +This procedure will list all of the files in a directory. It is also possible to show details about the files to confirm settings. .Prerequisites -* Sentence or a bulleted list of pre-requisites that must be in place or done before the user starts this procedure. - -* Delete section title and bullets if the procedure has no required pre-requisites. - -* Text can be a link to a pre-requisite module that the user must do before starting this module. - +* You must be at a shell prompt in the directory you wish to examine. .Procedure -_Put steps in a numbered list. The step sequence is important to a repeatable successful outcome._ - -. Start each step with an active verb, because each step corresponds to one user action. - -. Include one command or action per step. - -. Format the step line as an unnumbered bullet if the procedure includes only 1 step (exception to numbering the steps). - -. Include one command or action per step. - -. Include one command or action per step. - - -.Related Information - -* Bulleted list of links to concepts, reference, or other procedures closely related to this module. - -* Include only the most relevant items as links, not every possible related item. - -* Delete section title and bullets if no related information is needed. +. Execute the `ls -la` command. The `-la` option causes details about the files permissions, owner, group ownership, size and last modification date to be listed. ++ +[subs="+quotes"] +---- +ls -la +----