FAQ docs reformat. Minute Typos

.github/ISSUE_TEMPLATE/dev_console_issue.yaml

@@ -0,0 +1,31 @@
+name: Developer Console issue
+description: Create an issue report to help us improve the Developer Console.
+title: "[Dev Console]"
+labels:
+  - dev-console
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out a bug report!
+
+        Please provide a descriptive title above and fill in the following fields.
+
+  - type: textarea
+    id: Description
+    attributes:
+      label: Issue description
+      description: Describe the issue you encountered and what you expected to happen.
+    validations:
+      required: true
+
+  - type: textarea
+    id: Steps
+    attributes:
+      label: Steps to reproduce
+      description: Provide the specific steps to reproduce the issue.
+      value: |
+        - Add screenshots if possible, to help explain the problem.
+        - Include anything that might help us debug the issue.
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/doc_issue.yaml

@@ -0,0 +1,38 @@
+name: Documentation issue
+description: Report a problem with the Mojo docs
+title: "[Docs]"
+labels:
+  - "documentation,mojo-repo"
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for helping us improve the Mojo docs!
+
+        Please add a title above and fill in the following fields so we can understand the problem.
+
+  - type: input
+    id: url
+    attributes:
+      label: Where is the problem?
+      description: Provide a link to the problematic page (with a heading anchor).
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: What can we do better?
+      description: Describe the documentation problem and how you suggest we fix it.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Anything else?
+    validations:
+      required: false
+
+  - type: markdown
+    attributes:
+      value: |
+        Thank you!

.github/ISSUE_TEMPLATE/magic_cli_issue.yaml

@@ -0,0 +1,59 @@
+##===----------------------------------------------------------------------===##
+# Copyright (c) 2024, Modular Inc. All rights reserved.
+#
+# Licensed under the Apache License v2.0 with LLVM Exceptions:
+# https://llvm.org/LICENSE.txt
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+##===----------------------------------------------------------------------===##
+
+name: Magic CLI issue
+description: Create an issue for the Magic CLI tool.
+title: "[Magic CLI]: "
+labels:
+  - magic-cli
+  - mojo-repo
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out an issue report!
+
+        Please provide a descriptive title above and fill in the following fields.
+
+  - type: textarea
+    id: Description
+    attributes:
+      label: Issue description
+      description: Describe the issue you encountered and what you expected to happen.
+    validations:
+      required: true
+  - type: textarea
+    id: Steps
+    attributes:
+      label: Steps to reproduce
+      description: Provide the specific steps to reproduce the issue.
+      value: |
+        - Include relevant code snippet that did not work as expected.
+        - If applicable, add screenshots to help explain the problem.
+        - Include anything else that might help us debug the issue.
+    validations:
+      required: true
+
+  - type: textarea
+    id: Context
+    attributes:
+      label: Version Info
+      description: Which version of the Magic CLI are you using?
+      value: |
+        - Provide magic CLI version by pasting the output of `magic --version`
+        - What OS did you install the magic CLI on?
+        - If you're on Linux include the flavor and version e.g. Ubuntu 22.04.
+        - Include your CPU architecture e.g. x86-64 or arm64.
+        - If related to unresolvable dependencies, include the contents of your
+        `magic.lock` file.
+      render: shell

.github/ISSUE_TEMPLATE/mojo_bug_report.yaml

@@ -0,0 +1,45 @@
+name: Mojo bug report
+description: Create a bug report to help us improve Mojo
+title: "[BUG]"
+labels:
+  - "bug,mojo-repo"
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out a bug report!
+
+        Please provide a descriptive title above and fill in the following fields.
+
+  - type: textarea
+    id: Description
+    attributes:
+      label: Bug description
+      description: Describe the bug you encountered and what you expected to happen.
+    validations:
+      required: true
+
+  - type: textarea
+    id: Steps
+    attributes:
+      label: Steps to reproduce
+      description: Provide the specific steps to reproduce the issue.
+      value: |
+        - Include relevant code snippet or link to code that did not work as expected.
+        - If applicable, add screenshots to help explain the problem.
+        - If using the Playground, name the pre-existing notebook that failed and the steps that led to failure.
+        - Include anything else that might help us debug the issue.
+    validations:
+      required: true
+
+  - type: textarea
+    id: Context
+    attributes:
+      label: System information
+      description: What version of Mojo are you using?
+      value: |
+        - What OS did you do install Mojo on ?
+        - Provide version information for Mojo by pasting the output of `mojo -v`
+        - Provide Magic CLI version by pasting the output of `magic -V` or `magic --version` 
+        - Optionally, provide more information with `magic info`.
+      render: shell

.github/ISSUE_TEMPLATE/mojo_feature_request.yaml

@@ -0,0 +1,50 @@
+name: Mojo feature request
+description: Suggest an enhancement for Mojo
+title: "[Feature Request]"
+labels:
+  - "enhancement,mojo-repo"
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to suggest a Mojo enhancement!
+
+        Please enter a concise title above and fill out the following fields.
+
+  - type: checkboxes
+    id: Roadmap
+    attributes:
+      label: Review Mojo's priorities
+      description: Please take a look at our roadmap before you file a new feature request.
+      options:
+        - label: I have read the [roadmap and priorities](https://docs.modular.com/mojo/roadmap.html#overall-priorities) and I believe this request falls within the priorities.
+          required: true
+
+  - type: markdown
+    attributes:
+      value: |
+        If the request is out of the published roadmap and priorities, please start an [idea](https://github.com/modularml/mojo/discussions/categories/ideas) in GH Discussions to get feedback from the team.
+
+  - type: textarea
+    id: Request
+    attributes:
+      label: What is your request?
+      description: Describe how you'd like us to improve Mojo.
+    validations:
+      required: true
+
+  - type: textarea
+    id: Motivation
+    attributes:
+      label: What is your motivation for this change?
+      description: Describe the problem that your feature seeks to address (what is the value to the product/user?).
+    validations:
+      required: true
+
+  - type: textarea
+    id: Description
+    attributes:
+      label: Any other details?
+      description: Perhaps some minimum functional attributes the implementation should include, or other context about your feature.
+    validations:
+      required: false

.github/workflows/standard_library_tests_and_examples.yml

@@ -0,0 +1,72 @@
+# ===----------------------------------------------------------------------=== #
+# Copyright (c) 2024, Modular Inc. All rights reserved.
+#
+# Licensed under the Apache License v2.0 with LLVM Exceptions:
+# https://llvm.org/LICENSE.txt
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ===----------------------------------------------------------------------=== #
+
+name: Test stdlib and examples
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pull-requests: read
+
+jobs:
+  test-examples:
+    name: with ${{ matrix.os }} and assertions=${{ matrix.mojo-enable-assertions }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: ["ubuntu-latest", "macos-14"]
+        mojo-enable-assertions: [0, 1]
+
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 30
+
+    defaults:
+      run:
+        shell: bash
+    env:
+      DEBIAN_FRONTEND: noninteractive
+
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+
+      - name: Download Magic CLI
+        run: |
+          curl -ssL https://magic.modular.com/cfba4c92-2390-4b86-93de-04b2f47114d5 | bash
+
+          # Add magic to PATH
+          echo "$HOME/.modular/bin" >> $GITHUB_PATH
+
+          # Pin magic to older version to avoid HTTP timeouts and/or client certificate errors
+          # that manifest as a result of uv/python package solvers from Magic 0.3.0.
+          "$HOME/.modular/bin/magic" self-update --version 0.2.3
+
+      - name: Install build tools (Linux)
+        if: ${{ matrix.os == 'ubuntu-latest' }}
+        run: |
+          ./stdlib/scripts/install-build-tools-linux.sh
+
+      - name: Install build tools (macOS)
+        if: ${{ matrix.os == 'macos-14' }}
+        run: |
+          ./stdlib/scripts/install-build-tools-macos.sh
+
+      - name: Run standard library tests and examples
+        env:
+          MOJO_ENABLE_ASSERTIONS_IN_TESTS: ${{ matrix.mojo-enable-assertions }}
+        run: |
+          magic run tests
+          magic run examples

.gitignore

@@ -0,0 +1,22 @@
+# Build directory
+/build
+
+# Reference: https://github.com/github/gitignore/blob/main/Python.gitignore
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+.magic
+
+# MacOS
+.DS_Store

docs/oss-material/CODE_OF_CONDUCT.md → CODE_OF_CONDUCT.md

@@ -1,4 +1,4 @@
-# Code of Conduct
+# Code of conduct
 
 In the interest of fostering an open and welcoming environment, we as
 contributors and maintainers pledge to make participation in our project and
@@ -7,7 +7,7 @@ body size, disability, ethnicity, gender identity and expression, level of
 experience, nationality, personal appearance, race, religion, or sexual
 identity and orientation.
 
-## Our Standards
+## Our standards
 
 All community forums and spaces are meant for professional interactions that
 are friendly, inclusive, helpful, and collaborative. Examples of behavior that
@@ -32,7 +32,7 @@ participants include:
 - Conduct which could reasonably be considered inappropriate for the forum in
   which it occurs.
 
-## Our Responsibilities
+## Our responsibilities
 
 Project maintainers are responsible for clarifying the standards of acceptable
 behavior and are expected to take appropriate and fair corrective action in