diff --git a/changelog.d/4-docs/tweak-docs-2 b/changelog.d/4-docs/tweak-docs-2 new file mode 100644 index 00000000000..5164a3b9c67 --- /dev/null +++ b/changelog.d/4-docs/tweak-docs-2 @@ -0,0 +1 @@ +Make target audience explicit on docs.wire.com diff --git a/docs/src/developer/index.rst b/docs/src/developer/index.rst index 90df2360f8a..b48dbecae0a 100644 --- a/docs/src/developer/index.rst +++ b/docs/src/developer/index.rst @@ -1,6 +1,10 @@ Notes for developers ==================== +If you are an on-premise operator (administrating your own self-hosted installation of wire-server), you may want to go back to `docs.wire.com `_ and ignore this section of the docs. + +If you are a wire end-user, please check out our `support pages `_. + What you need to know as a user of the Wire backend: concepts, features, and API. We want to keep these up to date. They could benefit from some re-ordering, and they are far from complete, but we hope they will still diff --git a/docs/src/index.rst b/docs/src/index.rst index d3f356dd33d..a45427919b4 100644 --- a/docs/src/index.rst +++ b/docs/src/index.rst @@ -3,13 +3,18 @@ You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. -Welcome to Wire's (self-hosting) documentation! +Welcome to Wire's documentation! =============================================== +If you are a Wire end-user, please check out our `support pages `_. + The targeted audience of this documentation is: -* people wanting to understand how the server components of Wire work -* people wishing to self-host Wire on their own datacentres or cloud +* the curious power-user (people who want to understand how the server components of Wire work) +* on-premise operators/administrators (people who want to self-host Wire-Server on their own datacentres or cloud) +* developers (people who are working with the wire-server source code) + +If you are a developer, you may want to check out the "Notes for developers" first. This documentation may be expanded in the future to cover other aspects of Wire.