Add page listing Meson usage in proprietary projects.corporations

4 files changed, 51 insertions, 9 deletions

diff --git a/docs/markdown/Corporate-users.md b/docs/markdown/Corporate-users.md
new file mode 100644
index 000000000..63ecb1dd8
--- /dev/null
+++ b/docs/markdown/Corporate-users.md
@@ -0,0 +1,41 @@
+---
+title: Corporate users
+...
+
+# List of companies using Meson.
+
+In addition to [open source projects](Users.md) Meson is also used by
+many corporations for their internal projects. This page lists some of
+them that we are aware of.
+
+If you'd like to have your company project shown on this page, see the
+instructions at the bottom of this page.
+
+Open source projects are listed on [their own page](Users.md).
+
+## Projects with public info
+
+Company X wrote a blog post about their usage of Meson on [this page
+here](https://not.a.real.url).
+
+## Projects with comments
+
+"We use Meson for our X project and it has made us Y% more
+productive." -Developer McDeveloperface, Foo corp
+
+## Companies using Meson
+
+- Bob incorporated uses Meson to build the firmware of their
+  flibbertigibbet device.
+
+# Adding new entries
+
+We welcome new entries to this page. The procedure is quite simple:
+get approval from the PR department of your company (if needed) and
+then file a merge request with the necessary information.
+
+As you can probably guess, the more information your entry is, the
+higher up on the page it gets.
+
+The boring legalese: we reserve the right to reorder and/or remove
+entries on this page as we see fit.
diff --git a/docs/markdown/Users.md b/docs/markdown/Users.md
index a18b3029e..e709abad0 100644
--- a/docs/markdown/Users.md
+++ b/docs/markdown/Users.md
@@ -2,16 +2,18 @@
 title: Users
 ...
 
-# List of projects using Meson
+# List of open source projects using Meson
 
 If you have a project that uses Meson that you want to add to this
 list, please [file a
 pull-request](https://github.com/mesonbuild/meson/edit/master/docs/markdown/Users.md)
 for it. All the software on this list is tested for regressions before
-release, so it's highly recommended that projects add themselves
-here. Some additional projects are listed in the [`meson` GitHub
+release, so it's highly recommended that projects add themselves here.
+Some additional projects are listed in the [`meson` GitHub
 topic](https://github.com/topics/meson).
 
+Closed source projects are listed [on their own page](Corporate-Users.md).
+
  - [2048.cpp](https://github.com/plibither8/2048.cpp), a fully featured terminal version of the game "2048" written in C++
  - [Adwaita Manager](https://github.com/AdwCustomizerTeam/AdwCustomizer), change the look of Adwaita, with ease
  - [Aravis](https://github.com/AravisProject/aravis), a glib/gobject based library for video acquisition using Genicam cameras
diff --git a/docs/markdown/index.md b/docs/markdown/index.md
index 427cc0508..f8c3d1638 100644
--- a/docs/markdown/index.md
+++ b/docs/markdown/index.md
@@ -44,13 +44,11 @@ of the Meson GitHub repository.
 
 ### [Projects using Meson](Users.md)
 
-Many projects are using Meson and they're
-a great resource for learning what to (and what not to!) do when
-converting existing projects to Meson.
+[A short list of open source projects using Meson can be found
+here](Users.md) but there are many more.
 
-[A short list of Meson users can be found here](Users.md)
-but there are many more. We would love to hear about your success
-stories too and how things could be improved too!
+Meson is also used by many proprietary projects. [Some of them are
+listed on this page](Corporate-users.md).
 
 ## Development
 
diff --git a/docs/sitemap.txt b/docs/sitemap.txt
index 3aab953f2..af1525114 100644
--- a/docs/sitemap.txt
+++ b/docs/sitemap.txt
@@ -133,6 +133,7 @@ index.md
 		Porting-from-autotools.md
 		Use-of-Python.md
 		Users.md
+		Corporate-users.md
 		Using-multiple-build-directories.md
 		Vs-External.md
 	Contributing.md