From a862c6de1d086f9d91f973065907d2df67a64969 Mon Sep 17 00:00:00 2001 From: Lamparter Date: Sun, 24 Nov 2024 18:47:35 +0000 Subject: [PATCH] Improve `README.md` Signed-off-by: Lamparter --- .github/README.md | 91 ++++++++++++++++++++++++++++------------------- 1 file changed, 55 insertions(+), 36 deletions(-) diff --git a/.github/README.md b/.github/README.md index d1ab6925..1945fbd6 100644 --- a/.github/README.md +++ b/.github/README.md @@ -1,45 +1,64 @@ -Dynamic Language Runtime -======================== -The Dynamic Language Runtime enables language developers to more easily create dynamic languages for the .NET platform. In addition to being a pluggable back-end for dynamic language compilers, the DLR provides language interop for dynamic operations on objects. The DLR has common hosting APIs for using dynamic languages as libraries or for scripting in your .NET applications. - -| **What?** | **Where?** | -| --------: | :------------: | -| **Windows/Linux/macOS Builds** | [![Build status](https://dotnet.visualstudio.com/IronLanguages/_apis/build/status/DLR)](https://dotnet.visualstudio.com/IronLanguages/_build/latest?definitionId=41) [![Github build status](https://github.com/IronLanguages/dlr/workflows/CI/badge.svg)](https://github.com/IronLanguages/dlr/actions?workflow=CI) | -| **Downloads** | [![NuGet](https://img.shields.io/nuget/v/DynamicLanguageRuntime.svg)](https://www.nuget.org/packages/DynamicLanguageRuntime/) [![Release](https://img.shields.io/github/release/IronLanguages/dlr.svg)](https://github.com/IronLanguages/dlr/releases/latest)| -| **Help** | [![Gitter chat](https://badges.gitter.im/IronLanguages/ironpython.svg)](https://gitter.im/IronLanguages/ironpython) [![StackExchange](https://img.shields.io/stackexchange/stackoverflow/t/dynamic-language-runtime.svg)](http://stackoverflow.com/questions/tagged/dynamic-language-runtime) | - -Code of Conduct ---------------- -This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. -For more information see the [.NET Foundation Code of Conduct](https://dotnetfoundation.org/code-of-conduct). +

πŸŒ† Dynamic Language Runtime

+ +

+ + CI Status + + + Discuss on StackOverflow +

+ +Introducing the **Dynamic Language Runtime**, an efficient, CLR-friendly language platform that allows developers to create languages that integrate tightly with .NET. +In addition to being a pluggable back-end for dynamic language compilers, the DLR provides language interop for dynamic operations on objects. The DLR has common hosting APIs for using dynamic languages as libraries or for scripting in your .NET applications. + +## πŸ› οΈ Building from source + +#### 1. Prerequisites + +- [Visual Studio](https://visualstudio.microsoft.com/vs/) 2019 16.8.0 or later with the following individual components: + - .NET SDK +- Git + +#### 2. Clone the repository + +``` +git clone https://github.com/RiversideValley/Dynamic +``` -Installation ------------- -The best way to install the DLR is through the NuGet DynamicLanguageRuntime package. +This will create a local copy of the repository. -Documentation -------------- -The best current documentation is in the Docs/ directory, in Word and PDF format (it *was* a Microsoft project, after all). +#### 3. Build the project -Help ----- -If you have any questions, [open an issue](https://github.com/IronLanguages/dlr/issues/new), even if it's not an actual bug. The issues are an acceptable discussion forum as well. +To build the DLR for development, open the `Dynamic.sln` item in Visual Studio. Right-click on the `Riverside.Dynamic` project in solution explorer and select β€˜Set as Startup item’, then build the project. -History -------- -The original DLR site is at [CodePlex](http://dlr.codeplex.com). The DLR was part of a much larger repository containing IronPython and IronRuby as well; you can find it at the [main](https://github.com/IronLanguages/main) repository. This is a smaller repository containing just the DLR, which makes it easier to package and should make it easier to do more regular releases. +> Since the main development is on Windows, cross-platform bugs may inadvertantly be introduced - please report them! -Build ------ -You will need to have Visual Studio 2019 16.8.0 or later installed on your machine. +## βŒ› History of the project -On Windows machines, start a Visual Studio command prompt and type: +The original DLR site was available on CodePlex at `dlr.codeplex.com`. The DLR was part of a much larger repository containing IronPython and IronRuby as well; you can find it at the [main](https://github.com/IronLanguages/main) repository (now `IronLanguages/IronRuby` and `IronLanguages/IronPython3`). +This is a smaller repository containing just the DLR, which makes it easier to package and should make it easier to do more regular releases. + +Since this used to be a Microsoft project, the documentation is written in Microsoft Word format (of course) inside the `Microsoft` directory. + +## πŸ™‹ Contributing + +There are multiple ways to participate in the community: + +- Upvote popular feature requests +- [Submit a new feature](https://github.com/RiversideValley/Dynamic/pulls) +- [File bugs and feature requests](https://github.com/RiversideValley/Dynamic/issues/new/choose). +- Review source [code changes](https://github.com/RiversideValley/Dynamic/commits) + +We thank all contributors and users for their continued support. + +### πŸ€— Code of Conduct + +This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. +For more information see the [.NET Foundation Code of Conduct](https://dotnetfoundation.org/code-of-conduct). - > make - -On Unix machines, make sure Mono is installed and in the PATH, and type: +### βš–οΈ License - $ make +Copyright (c) 2006-2024 .NET Foundation. All Rights Reserved. -Since the main development is on Windows, Mono bugs may inadvertantly be introduced -— please report them! +Licensed under the `Apache-2.0` license as stated in the [LICENSE](https://github.com/RiversideValley/Dynamic/blob/ec74320579aca1d02013d2294253263e848f448b/LICENSE.md).