contributing guide: add section for docs
Adds a section for documentation.
Part of
@@ -207,6 +207,11 @@ Date: Thu Feb 2 11:41:15 2018 -0800
Notice the `Author` and `Signed-off-by` lines match. If they don't your PR will be rejected by the
automated DCO check.
+## Contributing Documentation
+OSM's primary documentation is made available at https://docs.openservicemesh.io/. Any documentation content that needs to be visible on the website must be created in the `docs/content` folder. Content that should not be served on the website must be created outside the `docs/content` folder. Since it is hard to have links to markdown file references that are navigable both on the `docs.openservicemesh.io` website and Github, the project has prioritized the website experience over Github. This means it is okay for links to be navigable on the website but not on Github. Any content that is available on the website must be made navigable within the website and not redirect to Github.
+
+Refer to the [OSM documentation guide](https://github.com/openservicemesh/osm/blob/main/docs/README.md) for more details.
+
## Roadmap
We use [GitHub Project Boards](https://github.com/openservicemesh/osm/projects) to help give a high level overview and track what work is going on and what stage it is in. If you want an idea of our roadmap and prioritization, this is the best place to find that information.
