Info | ||
---|---|---|
| ||
Certain steps are skippable; as such, they are not mentioned in the Tl;dr version. Reference the detailed steps to see them. |
Tl;dr
Jira
...
- For New or Existing Projects
- Create a ticket for the project / requested changes for a project
- Move ticket from "Backlog" to "In Progress" workflow stage
- When done, notify customer / Move ticket to "Under Review"
- Log work & add a closing comment with
- pertinent details (e.g. go-live approved by name/date/time etc.)
Stash
- For new projectsNew Projects:
- Create a new repository in FNF project
- Clone repository to local (using Sourcetree)
- Add the nitro file from Leap TEST environment
- Commit and push to master (from local to remote),
- When committing, include the Jira ticket, by using a string "JIRA <TICKET>" (example: "JIRA FEB-530")
- For existing projects:
- Do the Steps 2 - 4, above
Confluence
Update the project requirements page, under the FEB space:
- For new projects:
- Update the Document Properties box:
- "Document Status" at the top and other sections (such as Pre Go-Live, etc,) as necessary
- Update the Document Properties box:
- For existing projects: Update the
- branch,
- Create a tag and notify Jason Card for it to be released to PROD
- For Existing Projects:
- Do Steps 3 - 5, above
Confluence
- For New Projects:
- Add a project requirements page
- Add all the pertinent information related to this project
- When ready to go live, update the Document Properties box and and any other sections as necessary
- For Existing Projects:
- Update the project's requirements page
- Update the "Post Production Enhancement List" section
- Update the project's requirements page
- After receiving confirmation/notification for Stash step #18 (that the tag has been deployed in PROD)
- Update Version (in PROD) property (Document Properties box) with the latest version
Jira
Update the ticket
- Provide the following details in comments: Who approved the go-live and when.
- If possible/you'd like to, attach the email confirmation to the comments
- AFTER completing the Stash steps: Move the ticket from "UNDER REVIEW" to "DONE" column; ensure that the ticket's workflow status is "DONE" and not "CANCELLED"
- Notify Jason Card that the "Tag" has been created (Stash step #18)
Stash
...
- After the changes have gone live:
- Add release date to the "Post Production Enhancement List" section
- After the changes have gone live:
Customer Notification
- For New or Existing Projects:
- Copy links for Form(s) and View Responses page from Leap PROD environment
- Notify customer/team that the latest changes have gone live and provide the links
...
Anchor | ||||
---|---|---|---|---|
|
Info | ||
---|---|---|
| ||
Skippable steps are indicated by "(Optional)". You may choose to skip these steps, depending on your work-style — Use your best judgement!
|
Jira
Tip | ||
---|---|---|
| ||
It is prudent to do these steps throughout the life-cycle of the ticket (vs. doing them when closing the ticket), as it helps with accurately logging the work / time spent / updates from the customer with respect to changes in the scope of (intial) requested changes etc, |
For New or Existing Projects
Step # | Description | |||||||||
---|---|---|---|---|---|---|---|---|---|---|
1 | If new project:
If existing project:
| |||||||||
2 | (Optional) Log the estimated effort | |||||||||
3 | If the ticket is in the "Backlog", move it to "In Progress" when you start working on the changes | |||||||||
4 | (Optional) If existing project:
| |||||||||
5 | (Optional) As you progress, through the requested change(s)— a. Add comments as necessary b. Log work / time spent | |||||||||
6 | (Optional) If scope change occurs (i.e. additional changes are requested by the customer), you may create a Smart Checklist. Markdown syntax is used for adding items and it is pretty simple and straight-forward.
| |||||||||
7 | When all requested changes are complete, notify customer and move the ticket into "Under Review" workflow stage | |||||||||
8 | Upon receiving confirmation from the customer that all changes have been tested, verified, and confirmed, provide the following details in comments: a. Who approved the go-live and when. i. (Optional) Attach the confirmation email from customer to the comments b. Log work / time spent |
Stash
Anchor | ||||
---|---|---|---|---|
|
Brand New Project
Step # | Description | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 | Login to stash: https://stash.uconn.edu/ | ||||||||||||||||||
2 | Navigate to FEB Nitro Files (FNF) project | ||||||||||||||||||
3 | Provided you have the necessary privileges, click on the "Create repository" button, top-right | ||||||||||||||||||
4 | Provide an appropriate name and then click on the "Create repository" button | ||||||||||||||||||
5 | Clone repository to local — this is your local repository
| Create a. Create a project directory for this Leap application | Use b. Use git/bash command:
| ||||||||||||||||
6 | Open up Sourcetree software | ||||||||||||||||||
7 | Add a new repository, by clicking on the "+" at the top: a. Click on Add at the top: b. Click on "Browse" c. Navigate to where you cloned locally (Step 5.a., above) d. And click on "Select Folder" | ---- — DO NOT click on the .git folder... merely ensure that the folder you select has a .git folder (this is a hidden folder — so you might not see it, based on your settings), as shown below e. Finally, click "Add"
| |||||||||||||||||
8 | Go to Leap TEST environment and export the project (if you have not done it already) and save it locally
| ||||||||||||||||||
9 | Locate the *.nitro_s file that you downloaded from Leap TEST environment and move it to the directory of your project's local repository (same folder as 5.a., above) | ||||||||||||||||||
10 | Sourcetree automatically detects a change in | the your local repository | and list it ; it's time to stage your project's nitro file — Reference the screenshot below for steps 10.a & 10.b: a. Your project's nitro file will be listed under "Unstaged files" section | b. Click on
| |||||||||||||||
11 |
| ||||||||||||||||||
12 | Committing to remote repository — Reference the screenshot below for steps 12.a — 12.c: a. Under comments, use the following format — the first comment line & its format is mandatory!
(where XXX-### is the Jira ticket; you can provide your comments after that) |
b. Click on c. Click on the button | |||||||||||||||||
13 | Create a tag a. Click on "master" under "BRANCHES" on the left; notice that middle pane | b. Right-click on the | blue line Give it an appropriate name; generally, commit that you did in (Step 12, above) and select "Tag..." | c. In the resulting dialog box, under "Add Tag" tab i. Provide a name for the tag (this convention should work: "NAME_OF_REPO_v#.#" | (, where #.# is your version number e.g. 1.0, 1.1, etc.) | ii. Select/check the checkbox iii. Click the button | |||||||||||||
14 | Notify Jason Card that the tag "TAG_NAME" (from #13.c.i) has been created and it's ready to go live. Here's my notification template... feel free to use it, if it helps!
| . On
|
Anchor | ||||
---|---|---|---|---|
|
Existing Project
...
Step # | Description | |||||
---|---|---|---|---|---|---|
1 | On local machine, navigate to the project's directory where you have established your local repository
| |||||
2 | Delete the nitro_s file from this directory Continue | |||||
3 | Continue from Step 8 , on the Left |
Confluence
Confluence
For a Project's Initial Release
Step # | Description |
---|---|
1 | If the project requirements page does not have a |
...
Pre Go-Live Log section, add it |
...
: Pre Go-Live |
...
Log
| ||||||||||||||||||||||||
2 | Follow/go through the developer's checklist, as listed within the Pre Go-Live Log | |||||||||||||||||||||||
3 | Update the Document Properties box
| |||||||||||||||||||||||
4 | If you have done detailed documentation for your project, add a link to it right after the Document Properties box by: a. Adding an Info macro, with the following verbiage
b. Format the text as: Heading 2 c. Add a link back to the high-level requirements document on your detailed documentation page, with the following verbiage
d. Optional: if you have Table of Contents (ToC) macro on either the Detailed Documentation page or the High-Level Requirements Document page, edit the ToC macro and add the following RegEx so that it is excluded from it:
| |||||||||||||||||||||||
5 | Update any other details as necessary | |||||||||||||||||||||||
6 | Verify & confirm the accuracy of:
|
For a Project's Subsequent Releases
Step # | Description | |||||
---|---|---|---|---|---|---|
1 | Update the "Post Production Enhancement List" section— a. List the enhancements made at a high level i. (Optional) Provide a link to detailed documentation page where these enhancements are captured in detail b. Add customer name with Day/Date/Time of when it was approved to go live i. (Optional) Include the confirmation email c. Link the Jira issue d. Provide information for the other columns, which are self-explanatory
|
Customer Notification
Step # | Description | |||||||||
---|---|---|---|---|---|---|---|---|---|---|
1 | Login into Leap PROD environment: https://hclleap-prod2.its.uconn.edu/apps/login/org/index.html | |||||||||
2 | Search for your project | |||||||||
3 | Copy PROD links: a. Click on "Launch" and copy the link from the resulting page b. Click on "View Responses" and copy the link from the resulting page
| |||||||||
4 | Notify customer/team that the latest changes have gone live and provide the links Here's my notification template... feel free to use it, if it helps!
|