search

GSA / fedramp-automation

FedRAMP Automation
https://www.fedramp.gov/using-the-fedramp-oscal-resources-and-templates/
Other
293 stars 89 forks source link

Create screencast videos walking through install #694

Open aj-stein-gsa opened 2 months ago

aj-stein-gsa commented 2 months ago

User Story

As a developer consuming, integrating, and/or customizing FedRAMP Automation Team tools, to best educate and train myself, I would like to have a quick screencast video created to show how to cover the container-based installation of the FedRAMP validation toolchain.

Tasks

aj-stein-gsa commented 2 months ago

Hey @kyhu65867, I know we know we are doing this (and others on the FedRAMP Auto Team per standup today), but I thought it was important to put it on the board. Details on requirements and AC to follow. 😄

aj-stein-gsa commented 2 months ago

We had a tentative meeting with the comms review board with a video draft brief. Follow-on discussion will be needed for final review and a WIP example to show ROM effort and show rather than tell in the brief somewhere on Google Drive. There are some questions on how to use Articulate 360 for pre or post-production of the videos, if applicable.

@kyhu65867 and I are going to attempt to meet later today and move this forward.

aj-stein-gsa commented 2 months ago

A lot to improve later today or tomorrow, @kyhu65867, but this is my first pass:

https://drive.google.com/file/d/10LqVSIWeQLbBfXr1e2R7fewFNr_u6heN/view?usp=sharing

Things to change:

  1. Get rid of my avatar in the corner, yuck.
  2. Good OPSEC: make sure my username does not show up in the top banner of the terminal (you can tell I changed it in the prompt).
  3. Perhaps reconsider Zoom recording, still seems kind of grainy.

Here is the current version of the demo-magic script I tried:

https://gist.github.com/aj-stein-gsa/408e8b1b3eb44c0b400c089bfc9f78c7

I used the following command but still had to hit space to get it started, -n says don't wait for enter in some cases and -w waits for 10 seconds in this case. We can speed it up or slow it down.

 clear && sleep 15 && demo_video_01.sh -n -w 10

Let me know your further thoughts before adding it to the brief.

aj-stein-gsa commented 2 months ago

Take 2, with a slightly better demo-magic script updated in the Gist above. Had to use the screencapture (Cmd+Shift+5) in the OS to get this far and make it cleaner, as well change some of the terminal settings.

https://drive.google.com/file/d/10MHjRY2mtjK0O36GaeXvNfAHn6ct3FZe/view?usp=drive_link

Not sure how much of an improvement it is.

aj-stein-gsa commented 2 months ago

@kyhu65867 sent the brief (with demo) along for approval and review by @Marcia-Simms. We look forward to the feedback but will hold on that.

In the interim, Kylie and I will look into Articulate 360 and see if adding that or only using that for the video recording pipeline is a better fit. We can hold on this for now.

aj-stein-gsa commented 1 month ago

We need to look into software to annotate the video for accessibility purposes and integrate some feedback from Marcia Simms, so we will move this back into in progress and touch that up in short order and then ask for review. If it still has to wait, we will mark it as blocked.

Marcia-Simms commented 1 month ago

@aj-stein-gsa I'm fascinated by responding this way! 🥇 Let me know if it makes sense to share the video concept brief with OSC while you're working on accessibility and integration issues. If not, I will standby. Many thanks!

aj-stein-gsa commented 1 month ago

@kyhu65867 worked on the table and I provided very minor feedback. @kyhu65867 if you read to pass back for another review, I defer to you.

aj-stein-gsa commented 1 month ago

Since we are in the middle of other things I am going to put this in "ready" state for us to pick up in the next time around.