PR scoping & comments

microsoft · May 6, 2022 · 6a3fea6 · 6a3fea6
1 parent e48713e
commit 6a3fea6
Show file tree

Hide file tree

Showing 2 changed files with 5 additions and 6 deletions.
diff --git a/docs/examples/modify-baseline-to-pin-old-boost.md b/docs/examples/modify-baseline-to-pin-old-boost.md
@@ -77,9 +77,10 @@ An easy way to set the version for the entirety of boost is to use the `"builtin
 As of right now, it is only possible to go back to Boost version `1.75.0` using a baseline, since that was the contemporary Boost version when the versioning feature was merged. **But, it is possible to modify the baseline to whatever you like and use that instead.**
 
 ### Step 1: Create a new branch
-As described in the versioning documentation. The value that goes in `"builtin-baseline"` is a git commit in the Microsoft/vcpkg repository's history. If you want to customize the baseline and have control over the vcpkg instance, you can create a new commit with said custom baseline.
+As described in the versioning documentation. The value that goes in `"builtin-baseline"` is a git commit in the microsoft/vcpkg repository's history. If you want to customize the baseline and have control over the vcpkg instance, you can create a new commit with said custom baseline.
 
 Let's start by creating a new branch to hold our modified baseline.
+
 In the directory containing your clone of the vcpkg Git repository run:
 
 ```

diff --git a/docs/examples/overlay-triplets-linux-dynamic.md b/docs/examples/overlay-triplets-linux-dynamic.md
@@ -1,12 +1,10 @@
 # Overlay triplets example
 
-`vcpkg` comes with many useful officially supported configurations in the box, including dynamic and static libraries for Windows as well as static libraries for MacOS and Linux. There are also a large number of community-supported triplets available, such as Emscripten or Android.
-
-For more advanced customization, users can provide their own triplets via the Overlay Triplets mechanism. See our [triplets documentation](../users/triplets.md) for an exhaustive reference of what can be configured in a triplet file.
-
 ## Building dynamic libraries on Linux
 
-As a concrete example, this document will guide you through creating your own custom triplets with `--overlay-triplets` to easily build dynamic libraries on Linux.
+Using **vcpkg** you can build libraries for many configurations out of the box. However, this doesn't currently include shared libraries on Linux and Mac OS.
+
+This doesn't mean that you cannot use **vcpkg** to build your dynamic libraries on these platforms! This document will guide you through creating your own custom triplets with `--overlay-triplets` to easily build dynamic libraries on Linux.
 
 ### Step 1: Create the custom triplet files