docs/fundamentals/index.yml

### YamlMime:Landing

title: .NET fundamentals documentation
summary: Learn the fundamentals of .NET, an open-source developer platform for building many different types of applications.

metadata:
  title: .NET documentation
  description: Learn about .NET, an open-source developer platform for building many different types of applications.
  ms.topic: landing-page
  ms.date: 11/14/2023

# linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | sample | tutorial | video | whats-new

landingContent:
  # Card
  - title: Learn about .NET
    linkLists:
      - linkListType: download
        links:
          - text: Download .NET
            url: https://dotnet.microsoft.com/download
      - linkListType: overview
        links:
          - text: What is .NET?
            url: https://dotnet.microsoft.com/learn/dotnet/what-is-dotnet
          - text: Introduction to .NET
            url: ../core/introduction.md
          - text: .NET languages
            url: ../fundamentals/languages.md
      - linkListType: concept
        links:
          - text: .NET Standard
            url: ../standard/net-standard.md
          - text: Common Language Runtime (CLR)
            url: ../standard/clr.md
          - text: .NET Core support policy
            url: https://dotnet.microsoft.com/platform/support/policy/dotnet-core
      - linkListType: whats-new
        links:
          - text: What's new in .NET 10
            url: ../core/whats-new/dotnet-10/overview.md
          - text: What's new in .NET 9
            url: ../core/whats-new/dotnet-9/overview.md
          - text: What's new in .NET 8
            url: ../core/whats-new/dotnet-8/overview.md
          - text: What's new in .NET 7
            url: ../core/whats-new/dotnet-7.md
          - text: What's new in .NET 6
            url: ../core/whats-new/dotnet-6.md

  # Card
  - title: Install .NET
    linkLists:
      - linkListType: overview
        links:
          - text: Select which .NET version to use
            url: ../core/versions/selection.md
      - linkListType: how-to-guide
        links:
          - text: Install .NET SDK
            url: ../core/install/windows.md
          - text: Install .NET runtime
            url: ../core/install/windows.md
          - text: Use a Linux package manager to install
            url: ../core/install/linux-ubuntu.md
          - text: Check installed versions
            url: ../core/install/how-to-detect-installed-versions.md
      - linkListType: reference
        links:
          - text: .NET SDK and runtime dependencies
            url: ../core/install/windows.md

  # Card
  - title: Get started with .NET
    linkLists:
      - linkListType: get-started
        links:
          - text: Get started with .NET
            url: ../core/get-started.md
          - text: Get started with ASP.NET Core
            url: /aspnet/core/
          - text: .NET on Q&A
            url: /answers/products/dotnet
          - text: .NET tech community forums
            url: https://techcommunity.microsoft.com/t5/net/ct-p/dotnet
      - linkListType: video
        links:
          - text: "Tutorial: Hello World in 10 minutes"
            url: https://dotnet.microsoft.com/learn/dotnet/hello-world-tutorial/intro
      - linkListType: tutorial
        links:
          - text: Create a Hello World app in Visual Studio Code
            url: ../core/tutorials/with-visual-studio-code.md
          - text: Create a Hello World app in Visual Studio
            url: ../core/tutorials/with-visual-studio.md
          - text: Containerize a .NET Core app
            url: ../core/docker/build-container.md
      - linkListType: concept
        links:
          - text: Port from .NET Framework to .NET
            url: ../core/porting/index.md
      - linkListType: deploy
        links:
          - text: App publishing
            url: ../core/deploying/index.md
          - text: Publish .NET apps with GitHub Actions
            url: ../devops/dotnet-publish-github-action.md

  # Card
  - title: Serialize data
    linkLists:
      - linkListType: concept
        links:
          - text: Serialize and deserialize JSON
            url: ../standard/serialization/system-text-json/overview.md
      - linkListType: how-to-guide
        links:
          - text: Serialize and deserialize JSON using C#
            url: ../standard/serialization/system-text-json/how-to.md
          - text: Migrate from Newtonsoft.Json to System.Text.Json
            url: ../standard/serialization/system-text-json/migrate-from-newtonsoft.md
          - text: Write custom converters for JSON serialization
            url: ../standard/serialization/system-text-json/converters-how-to.md
      - linkListType: sample
        links:
          - text: Examples of XML serialization
            url: ../standard/serialization/examples-of-xml-serialization.md

  # Card
  - title: Runtime libraries
    linkLists:
      - linkListType: overview
        links:
          - text: Runtime libraries overview
            url: ../standard/runtime-libraries-overview.md
      - linkListType: concept
        links:
          - text: Dependency injection in .NET
            url: ../core/extensions/dependency-injection.md
          - text: Configuration in .NET
            url: ../core/extensions/configuration.md
          - text: Logging in .NET
            url: ../core/extensions/logging.md
          - text: .NET generic host
            url: ../core/extensions/generic-host.md
          - text: Worker services in .NET
            url: ../core/extensions/workers.md
          - text: Caching in .NET
            url: ../core/extensions/caching.md
          - text: HTTP in .NET
            url: networking/http/httpclient-guidelines.md
          - text: Localization in .NET
            url: ../core/extensions/localization.md
          - text: File globbing in .NET
            url: ../core/extensions/file-globbing.md
      - linkListType: tutorial
        links:
          - text: Implement a custom configuration provider
            url: ../core/extensions/custom-configuration-provider.md
          - text: Compile-time logging source generation
            url: ../core/extensions/logger-message-generator.md
          - text: Create a Windows Service using BackgroundService
            url: ../core/extensions/windows-service.md

  # Card
  - title: Format and convert dates, numbers, and strings
    linkLists:
      - linkListType: concept
        links:
          - text: Numeric format strings
            url: ../standard/base-types/standard-numeric-format-strings.md
          - text: Date and time format strings
            url: ../standard/base-types/standard-date-and-time-format-strings.md
          - text: Composite formatting
            url: ../standard/base-types/composite-formatting.md
          - text: Convert times between time zones
            url: ../standard/datetime/converting-between-time-zones.md
          - text: Trim and remove characters from strings
            url: ../standard/base-types/trimming.md
          - text: Regular expressions in .NET
            url: ../standard/base-types/regular-expressions.md
      - linkListType: how-to-guide
        links:
          - text: Convert strings to DateTime
            url: ../standard/base-types/parsing-datetime.md
          - text: Pad a number with leading zeros
            url: ../standard/base-types/how-to-pad-a-number-with-leading-zeros.md
          - text: Display milliseconds in date and time values
            url: ../standard/base-types/how-to-display-milliseconds-in-date-and-time-values.md
      - linkListType: reference
        links:
          - text: Regular expression language
            url: ../standard/base-types/regular-expression-language-quick-reference.md

  # Card
  - title: Use events and exceptions
    linkLists:
      - linkListType: concept
        links:
          - text: Best practices for exceptions
            url: ../standard/exceptions/best-practices-for-exceptions.md
          - text: Handle and raise events
            url: ../standard/events/index.md
      - linkListType: how-to-guide
        links:
          - text: Use a try-catch block to catch exceptions
            url: ../standard/exceptions/how-to-use-the-try-catch-block-to-catch-exceptions.md
          - text: Raise and consume events
            url: ../standard/events/how-to-raise-and-consume-events.md

  # Card
  - title: File and stream I/O
    linkLists:
      - linkListType: concept
        links:
          - text: File and stream I/O
            url: ../standard/io/index.md
          - text: File path formats on Windows
            url: ../standard/io/file-path-formats.md
      - linkListType: how-to-guide
        links:
          - text: Write text to a file
            url: ../standard/io/how-to-write-text-to-a-file.md
          - text: Read text from a file
            url: ../standard/io/how-to-read-text-from-a-file.md
          - text: Compress and extract files
            url: ../standard/io/how-to-compress-and-extract-files.md
          - text: Open and append to a log file
            url: ../standard/io/how-to-open-and-append-to-a-log-file.md