Merge branch 'main' into meetings/jan-29

Signed-off-by: Shauna Gordon <[email protected]>

README.md

@@ -42,7 +42,9 @@ Check out the [calendar](https://lists.o3de.org/calendar#) for events, and view
 
 ### Meeting Agenda
 
-Meetings are held every other Wednesday at 11:30am Eastern, 3:30pm UTC.
+Meetings are held every other Wednesday at 11:30am Eastern, 3:30pm UTC. 
+
+In the event a meeting conflicts with Connect or other major meeting, this one will be moved to after the conflicting one, usually pushing it back half an hour.
 
 _\*Event schedules may change. For an up-to-date schedule, see the official [O3DE calendar](https://lists.o3de.org/calendar#)._
 

meetings/README.md

@@ -30,11 +30,13 @@ O3DE cannot work without the help and input from as many of its community member
 | 2024-07-03 | [Link](https://github.com/o3de/sig-docs-community/issues/122) | [On Agenda](https://github.com/o3de/sig-docs-community/issues/122#issuecomment-2206868488) |
 | 2024-07-17 | [Link](https://github.com/o3de/sig-docs-community/issues/124) | [On Agenda](https://github.com/o3de/sig-docs-community/issues/124) |
 | 2024-08-14 | [Link](https://github.com/o3de/sig-docs-community/issues/128) | [On Agenda](https://github.com/o3de/sig-docs-community/issues/128) |
+| 2024-09-11 | N/A | [Link](notes/sig-meeting-20240911.md) |
 | 2024-09-25 | [Link](notes/sig-meeting-2024-09-25.md) | [On Agenda](https://github.com/o3de/sig-docs-community/issues/133) |
+| 2024-10-09 | [Link](https://github.com/o3de/sig-docs-community/issues/135) | [Link](notes/sig-meeting-20241009.md) |
+| 2024-11-20 | [Link](notes/sig-meeting-20241120.md) | [On Agenda](https://github.com/o3de/sig-docs-community/issues/137) |
 | 2025-01-29 | [Link](https://github.com/o3de/sig-docs-community/issues/140) | N/A |
 
 
-
 ## Pre-release meetings
 
 Preserved for posterity. Thanks to everyone who helped Open 3D Engine launch!

meetings/notes/sig-meeting-20240911.md

@@ -0,0 +1,49 @@
+# Docs & Community SIG meeting - 2024-09-11
+
+**Facilitator:**  Shauna Gordon (@ShaunaGordon)
+**Notes taker:**  Shauna Gordon (@ShaunaGordon)
+
+(Agenda not created for this meeting.)
+
+## SIG Updates
+
+Shauna 
+- reviewed/closed a couple of PRs
+
+Jan
+- Created stabilization branch, now redirecting PRs to it
+
+JT 
+- Still ramping up in-person stuff
+
+### Open questions
+
+2025 Docs Goals:
+
+- Rearchitect site for easier content contribution (Shauna to spearhead work on this)
+    - Side effect - ability to translate docs 
+      - Note - set up fallbacks to English if a page isn't yet translated
+        - It's not uncommon for only some pages to be translated, for various reasons
+- Flesh out the Engine Developer Guide (community effort)
+  - Lots of parts needed to be able to build a useful foundation
+  - Most of the internals were built by Amazon people, who have sense moved to other things. Need to find new people with knowledge of parts.
+
+### Action items
+
+- Cherry-pick stabilization commits back to dev (Jan will do once #2589 is merged)
+- Add new version to picker on website (just get PR in for now), Shauna will do
+- Jan will be reviewing Robotec docs to add upstream
+- Reminder: PR freeze 9/24
+- Shauna to share release process notes from firehose meeting a few months back
+
+
+## Miscellaneous
+
+- JT called out that he gives feedback of i18n verbiage to help disambiguate some words/phrases with international audiences (and avoid some faux pas from international definitions)
+- International Technical and Business Language Dictionary
+  - reference to standardize language for things like documentation for international audiences
+  - expensive to purchase, but maybe some people in the community already have copies/access to it and can help with reviewing content?
+- Game engine evaluator
+  - role in game studios
+  - looks at docs as part of analysis and often contribute back to docs
+  - a big reason to work to keep docs up to date and have regular activity

meetings/notes/sig-meeting-20241009.md

@@ -0,0 +1,19 @@
+# Docs & Community SIG meeting - 2024-10-10
+
+**Facilitator:**  Shauna Gordon (@ShaunaGordon)
+**Notes taker:**  Shauna Gordon (@ShaunaGordon)
+
+[Agenda](https://github.com/o3de/sig-docs-community/issues/135)
+
+## SIG Updates
+
+Updates from the SIG itself. Information will be provided in advance on the agenda issue.
+
+* 24.09 release day!
+* Final prep and staging of everything for release, getting PRs approved, etc
+
+## Miscellaneous
+
+Was there crosstalk or other useful discussion that happened during the meeting, but wasn't _specifically_ related to any of the agenda items?
+
+* squash merges are okay when it's a feature branch to a development or stabilization branch, but stabilization to main should always be merge commit so history is easily traceable

meetings/notes/sig-meeting-20241120.md

@@ -0,0 +1,29 @@
+# Docs & Community SIG meeting - 2024-11-20
+
+**Facilitator:**  Shauna Gordon (@ShaunaGordon)
+**Notes taker:**  Shauna Gordon (@ShaunaGordon)
+
+[Agenda](https://github.com/o3de/sig-docs-community/issues/133)
+
+## SIG Updates
+
+* Shauna and JT talked about goals for the coming year
+    * Both in agreement that the overarching goal is to make docs more approachable, both for engine users and docs contributors, through streamlining and better audience targeting
+* JT shared a bunch of information from his industry experience (see links below) and advocated a "Lean Documentation" approach. Both agreed that this is definitely necessary for a "quickstart" section that allows new engine users to go from 0 to something presentable in less than 3 hours
+    * His ultimate goal is to be able to get users productive on O3DE with as little as a few minutes of research for every hour of productive work (the "holy grail" of docs)
+* Audience targeting, using the "5 Computer Users" framework, will also help us identify actual people and groups in the community that we can approach as testers of the documentation. These people will allow us to refine that quickstart content to *actual* needs and use-cases.
+* As of meeting, Shauna still waiting on repos, but Joe's been swamped with the event circuit
+
+
+### Action items
+
+* Shauna to read up on resources JT shared
+* Shauna and JT to work on outlining design changes to facilitate new vision
+* Shauna to continue working on getting repos to break the Hugo site into API, theme, and content
+
+
+## Miscellaneous
+
+- https://en.wikipedia.org/wiki/Diffusion_of_innovations
+- https://www.computerchum.com/what-are-the-5-computer-users/
+- https://agilemodeling.com/essays/agileDocumentation.htm#WhenIsADocumentAgile