From b79ec5864a3c246356da5fc40185516078e2f4ab Mon Sep 17 00:00:00 2001 From: Deafveloper Date: Tue, 10 Sep 2024 00:34:31 -0400 Subject: [PATCH 1/4] Updated index.md added the sign language video style guide Signed-off-by: Deafveloper --- content/en/style-guide/_index.md | 109 ++++++++++++++++++++++++++++++- 1 file changed, 108 insertions(+), 1 deletion(-) diff --git a/content/en/style-guide/_index.md b/content/en/style-guide/_index.md index bab8303e7b..6db6eb25c7 100644 --- a/content/en/style-guide/_index.md +++ b/content/en/style-guide/_index.md @@ -26,7 +26,7 @@ Additionally, it follows the following rules: ## Audience The Glossary is written for technical *and* non-technical audiences. -Please explain definitions in simple terms, and don’t assume technical knowledge. More about this is below in [Definition](#definition). +Please explain definitions in simple terms, and don’t assume technical knowledge. More about this is below in [Definition](#definition) and the [Sign Language Style Guide](#sign-language-style-guide). ## Minimum viable definition @@ -164,6 +164,8 @@ Additionally, it uses a real-world example comparing network challenges in a mic to wifi problems (something anyone using a laptop can understand). Where possible, try to make that connection. + + #### Start with a Google or Word doc We recommend starting with a Google or Word doc, letting it sit for a few days, and revisiting it. @@ -176,6 +178,111 @@ More about that in the [How To Contribute](/contribute/) doc. Before getting started, please read some published Glossary terms to get a feeling for the level of detail and difficulty and when examples are appropriate. + + +## Sign Language Video Style Guide {#sign-language-style-guide} + + +### If you are contributing a sign language video, please follow these guidelines to ensure our videos are clear, informative, and accessible to a wide audience (Including hearing community members). + + +### Technical equipment + +All you need is a high-resolution camera and a stand. A modern smartphone should be enough. + + +### Recording Setup + + + +* +Lighting: Frontal light + + +* +Background: Record in front of a flat, solid background so it doesn't distract from the signing, and ensure no distracting decorations are included. + + +* +Dress Code: Solid single-color top (no prints) contrasting your skin tone. + + +* +Camera Position: Head to elbow should be on the screen and the camera should be positioned near the eye's height. The camera should also be perpendicular to the background (the background behind you should not be slanted). + + +* +Signing Space: Use as much space as possible, ensuring you have full signing space while sitting or standing. + + +* +Sound: Mute the microphone (input audio) when possible to avoid involuntary background noise. + +### Signing + + + +* +Clarity and Accuracy: Record the sign twice: frontally and from the side, and sign slowly enough, so non-signers can see and mimic it. + + +* +Facial Expression: Use relaxed or neutral facial expressions. Mouthing or making grimaces is strongly discouraged. Maintain your eyes on the camera if possible. + + +* +Frequency: Only one sign is enough for each video as playback can be looped. Repeating the sign in a video is unnecessary. + + +* +Duration: The total length of the video should not be more than 7 seconds. + + +* +Fingerspelling: Use sign language for the word as much as possible as fingerspelling is the last resort, commonly reserved for abbreviated or short words. + + +* +Posture: While signing, only maintain frontal orientation with eyes facing the camera while positioned. Demonstrating signs using side orientation is unnecessary. When at rest, arms should be down with hands relaxed. + +### Tips + + + +* +Save storage space: Please remember the shorter the video, the smaller the file would be. The quicker it would be when uploading. + + +* +Mistakes are good: Keep the recording running while making several attempts. It is more likely you will find a good clip in between several tries and you would only need to trim the unwanted parts out. This is more efficient than making multiple recordings with one sign attempt in each. + + +* +Videos Examples: Please refer to the [CNCF Glossary: Cloud Native Signs](https://www.youtube.com/playlist?list=PLj6h78yzYM2PDlYnmfpRfKgcgBMb34kb5) playlist for examples. + +### Post-Production + + + +* +Editing: If necessary, trim the beginning and the end. + + +* +Label: At a minimum, the filename of the video should contain the glossary term of the sign before uploading. + + +* +Audio: Remove the entire audio feed if applicable. + + +* +Upload: Please do not upload the videos to your personal YouTube as YouTube could potentially remove duplicate videos from all accounts using the same videos (to prevent monetizing abuse) as CNCF uses YouTube to upload final videos. + + +* +Video upload on CNCF playlist: Share the video on the #glossary-sign-language Slack channel and ask for feedback. If approved, the Sign Language Glossary leads will help you upload the video to the CNCF Playlist. + ## The review process: What to expect Please note that we are currently only three maintainers doing this in their spare time. From eaade8d136b56117f68c2a1f7d3c48e8fd39ee85 Mon Sep 17 00:00:00 2001 From: Destiny O'Connor <108372508+Deafveloper@users.noreply.github.com> Date: Thu, 12 Sep 2024 12:21:06 -0400 Subject: [PATCH 2/4] Fix the Sign Language Video Style Guide in _index.md Deleted extra space and made the text bold with the bullet points. Signed-off-by: Destiny O'Connor <108372508+Deafveloper@users.noreply.github.com> Signed-off-by: Deafveloper --- content/en/style-guide/_index.md | 60 +++++++++++--------------------- 1 file changed, 20 insertions(+), 40 deletions(-) diff --git a/content/en/style-guide/_index.md b/content/en/style-guide/_index.md index 6db6eb25c7..8c6d54b97c 100644 --- a/content/en/style-guide/_index.md +++ b/content/en/style-guide/_index.md @@ -195,93 +195,73 @@ All you need is a high-resolution camera and a stand. A modern smartphone should -* -Lighting: Frontal light +* **Lighting:** Frontal light -* -Background: Record in front of a flat, solid background so it doesn't distract from the signing, and ensure no distracting decorations are included. +* **Background:** Record in front of a flat, solid background so it doesn't distract from the signing, and ensure no distracting decorations are included. -* -Dress Code: Solid single-color top (no prints) contrasting your skin tone. +* **Dress Code:** Solid single-color top (no prints) contrasting your skin tone. -* -Camera Position: Head to elbow should be on the screen and the camera should be positioned near the eye's height. The camera should also be perpendicular to the background (the background behind you should not be slanted). +* **Camera Position:** Head to elbow should be on the screen and the camera should be positioned near the eye's height. The camera should also be perpendicular to the background (the background behind you should not be slanted). -* -Signing Space: Use as much space as possible, ensuring you have full signing space while sitting or standing. +* **Signing Space:** Use as much space as possible, ensuring you have full signing space while sitting or standing. -* -Sound: Mute the microphone (input audio) when possible to avoid involuntary background noise. +* **Sound:** Mute the microphone (input audio) when possible to avoid involuntary background noise. ### Signing -* -Clarity and Accuracy: Record the sign twice: frontally and from the side, and sign slowly enough, so non-signers can see and mimic it. +* **Clarity and Accuracy:** Record the sign twice: frontally and from the side, and sign slowly enough, so non-signers can see and mimic it. -* -Facial Expression: Use relaxed or neutral facial expressions. Mouthing or making grimaces is strongly discouraged. Maintain your eyes on the camera if possible. +* **Facial Expression:** Use relaxed or neutral facial expressions. Mouthing or making grimaces is strongly discouraged. Maintain your eyes on the camera if possible. -* -Frequency: Only one sign is enough for each video as playback can be looped. Repeating the sign in a video is unnecessary. +* **Frequency:** Only one sign is enough for each video as playback can be looped. Repeating the sign in a video is unnecessary. -* -Duration: The total length of the video should not be more than 7 seconds. +* **Duration:** The total length of the video should not be more than 7 seconds. -* -Fingerspelling: Use sign language for the word as much as possible as fingerspelling is the last resort, commonly reserved for abbreviated or short words. +* **Fingerspelling:** Use sign language for the word as much as possible as fingerspelling is the last resort, commonly reserved for abbreviated or short words. -* -Posture: While signing, only maintain frontal orientation with eyes facing the camera while positioned. Demonstrating signs using side orientation is unnecessary. When at rest, arms should be down with hands relaxed. +* **Posture:** While signing, only maintain frontal orientation with eyes facing the camera while positioned. Demonstrating signs using side orientation is unnecessary. When at rest, arms should be down with hands relaxed. ### Tips -* -Save storage space: Please remember the shorter the video, the smaller the file would be. The quicker it would be when uploading. +* **Save storage space:** Please remember the shorter the video, the smaller the file would be. The quicker it would be when uploading. -* -Mistakes are good: Keep the recording running while making several attempts. It is more likely you will find a good clip in between several tries and you would only need to trim the unwanted parts out. This is more efficient than making multiple recordings with one sign attempt in each. +* **Mistakes are good:** Keep the recording running while making several attempts. It is more likely you will find a good clip in between several tries and you would only need to trim the unwanted parts out. This is more efficient than making multiple recordings with one sign attempt in each. -* -Videos Examples: Please refer to the [CNCF Glossary: Cloud Native Signs](https://www.youtube.com/playlist?list=PLj6h78yzYM2PDlYnmfpRfKgcgBMb34kb5) playlist for examples. +* **Videos Examples:** Please refer to the [CNCF Glossary: Cloud Native Signs](https://www.youtube.com/playlist?list=PLj6h78yzYM2PDlYnmfpRfKgcgBMb34kb5) playlist for examples. ### Post-Production -* -Editing: If necessary, trim the beginning and the end. +* **Editing:** If necessary, trim the beginning and the end. -* -Label: At a minimum, the filename of the video should contain the glossary term of the sign before uploading. +* **Label:** At a minimum, the filename of the video should contain the glossary term of the sign before uploading. -* -Audio: Remove the entire audio feed if applicable. +* **Audio:** Remove the entire audio feed if applicable. -* -Upload: Please do not upload the videos to your personal YouTube as YouTube could potentially remove duplicate videos from all accounts using the same videos (to prevent monetizing abuse) as CNCF uses YouTube to upload final videos. +* **Upload:** Please do not upload the videos to your personal YouTube as YouTube could potentially remove duplicate videos from all accounts using the same videos (to prevent monetizing abuse) as CNCF uses YouTube to upload final videos. -* -Video upload on CNCF playlist: Share the video on the #glossary-sign-language Slack channel and ask for feedback. If approved, the Sign Language Glossary leads will help you upload the video to the CNCF Playlist. +* **Video upload on CNCF playlist:** Share the video on the #glossary-sign-language Slack channel and ask for feedback. If approved, the Sign Language Glossary leads will help you upload the video to the CNCF Playlist. ## The review process: What to expect From b6a3b0d548906577b5aa27e22ad8307162e08714 Mon Sep 17 00:00:00 2001 From: Destiny O'Connor <108372508+Deafveloper@users.noreply.github.com> Date: Thu, 12 Sep 2024 12:34:29 -0400 Subject: [PATCH 3/4] Update _index.md changed the heading into regular text under the SL video guide heading Signed-off-by: Destiny O'Connor <108372508+Deafveloper@users.noreply.github.com> Signed-off-by: Deafveloper --- content/en/style-guide/_index.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/content/en/style-guide/_index.md b/content/en/style-guide/_index.md index 8c6d54b97c..b269b40ee2 100644 --- a/content/en/style-guide/_index.md +++ b/content/en/style-guide/_index.md @@ -182,8 +182,7 @@ to get a feeling for the level of detail and difficulty and when examples are ap ## Sign Language Video Style Guide {#sign-language-style-guide} - -### If you are contributing a sign language video, please follow these guidelines to ensure our videos are clear, informative, and accessible to a wide audience (Including hearing community members). +If you are contributing a sign language video, please follow these guidelines to ensure our videos are clear, informative, and accessible to a wide audience (Including hearing community members). ### Technical equipment From 6d1728918c1efce086aeced32be9dd4c9e8caed6 Mon Sep 17 00:00:00 2001 From: Deafveloper Date: Sat, 26 Oct 2024 23:18:25 -0400 Subject: [PATCH 4/4] Update Index.md Added @tech-andgar Suggestions Signed-off-by: Deafveloper --- content/en/style-guide/_index.md | 34 ++++++++++++++++---------------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/content/en/style-guide/_index.md b/content/en/style-guide/_index.md index b269b40ee2..239ec4a183 100644 --- a/content/en/style-guide/_index.md +++ b/content/en/style-guide/_index.md @@ -194,19 +194,19 @@ All you need is a high-resolution camera and a stand. A modern smartphone should -* **Lighting:** Frontal light +* **Lighting:** Use frontal lighting to ensure your face and hands are well-lit. -* **Background:** Record in front of a flat, solid background so it doesn't distract from the signing, and ensure no distracting decorations are included. +* **Background:** Record in front of a flat, solid background to avoid distractions from the signing. Ensure no distracting decorations are included. -* **Dress Code:** Solid single-color top (no prints) contrasting your skin tone. +* **Dress Code:** Wear a solid, single-color top (no prints) that contrasts with your skin tone. -* **Camera Position:** Head to elbow should be on the screen and the camera should be positioned near the eye's height. The camera should also be perpendicular to the background (the background behind you should not be slanted). +* **Camera Position:** Ensure that your head to your elbows are visible on the screen, and position the camera at eye level. The camera should be perpendicular to the background so that it appears straight, not slanted. -* **Signing Space:** Use as much space as possible, ensuring you have full signing space while sitting or standing. +* **Signing Space:** Use as much space as possible to ensure you have full signing space while sitting or standing. * **Sound:** Mute the microphone (input audio) when possible to avoid involuntary background noise. @@ -215,31 +215,31 @@ All you need is a high-resolution camera and a stand. A modern smartphone should -* **Clarity and Accuracy:** Record the sign twice: frontally and from the side, and sign slowly enough, so non-signers can see and mimic it. +* **Clarity and Accuracy:** Record the sign twice from a frontal orientation, signing slowly enough for non-signers to see and mimic it. Demonstrating signs from the side is unnecessary unless it adds clarity. -* **Facial Expression:** Use relaxed or neutral facial expressions. Mouthing or making grimaces is strongly discouraged. Maintain your eyes on the camera if possible. +* **Facial Expression:** Use relaxed or neutral facial expressions. Mouthing or making grimaces is strongly discouraged. Maintain eye contact with the camera if possible. -* **Frequency:** Only one sign is enough for each video as playback can be looped. Repeating the sign in a video is unnecessary. +* **Frequency:** Only one sign is needed for each video, as playback can be looped. Repeating the sign in a video is unnecessary. -* **Duration:** The total length of the video should not be more than 7 seconds. +* **Duration:** The total length of the video should not exceed 7 seconds. -* **Fingerspelling:** Use sign language for the word as much as possible as fingerspelling is the last resort, commonly reserved for abbreviated or short words. +* **Fingerspelling:** Use sign language for the word as much as possible. Fingerspelling is the last resort, commonly reserved for abbreviated or short words. -* **Posture:** While signing, only maintain frontal orientation with eyes facing the camera while positioned. Demonstrating signs using side orientation is unnecessary. When at rest, arms should be down with hands relaxed. +* **Posture:** Maintain a frontal orientation with eyes facing the camera while signing. Demonstrating signs using side orientation is unnecessary. When at rest, arms should be down with hands relaxed. ### Tips -* **Save storage space:** Please remember the shorter the video, the smaller the file would be. The quicker it would be when uploading. +* **Save storage space:** Please remember the shorter the video, the smaller the file would be. The faster it will upload. -* **Mistakes are good:** Keep the recording running while making several attempts. It is more likely you will find a good clip in between several tries and you would only need to trim the unwanted parts out. This is more efficient than making multiple recordings with one sign attempt in each. +* **Mistakes are good:** Keep the recording running while making several attempts. It is more likely you will find a good clip in between tries, and you can trim the unwanted parts. This is more efficient than making multiple recordings with one sign attempt in each. * **Videos Examples:** Please refer to the [CNCF Glossary: Cloud Native Signs](https://www.youtube.com/playlist?list=PLj6h78yzYM2PDlYnmfpRfKgcgBMb34kb5) playlist for examples. @@ -248,16 +248,16 @@ All you need is a high-resolution camera and a stand. A modern smartphone should -* **Editing:** If necessary, trim the beginning and the end. +* **Editing:** If necessary, trim the beginning and the end of the video. -* **Label:** At a minimum, the filename of the video should contain the glossary term of the sign before uploading. +* **Label:** At a minimum, the filename of the video should contain the glossary term of the sign before uploading. For example, kubernetes.mp4. -* **Audio:** Remove the entire audio feed if applicable. +* **Audio:** Remove the audio track entirely, if possible. -* **Upload:** Please do not upload the videos to your personal YouTube as YouTube could potentially remove duplicate videos from all accounts using the same videos (to prevent monetizing abuse) as CNCF uses YouTube to upload final videos. +* **Upload:** Share the video on the #glossary-sign-language Slack channel and ask for feedback. If approved, the Sign Language Glossary leads will help you upload the video to the CNCF Playlist. Please do not upload the videos to your personal YouTube as YouTube could potentially remove duplicate videos from all accounts using the same videos (to prevent monetizing abuse) as CNCF uses YouTube to upload final videos. * **Video upload on CNCF playlist:** Share the video on the #glossary-sign-language Slack channel and ask for feedback. If approved, the Sign Language Glossary leads will help you upload the video to the CNCF Playlist.