|
| 1 | +# Contributing guidelines for closed content |
| 2 | + |
| 3 | +This document describes the process for authoring "closed content", which is content of a commercially sensitive nature that cannot be publicised before release. |
| 4 | + |
| 5 | +Commercially sensitive content might include: |
| 6 | + |
| 7 | +- Security content, including personally identifying information (PII). |
| 8 | +- Content / features that are not yet ready to be announced. |
| 9 | + |
| 10 | +We work in public by default, so this process should only be used on a case by case basis by F5 employees. For standard content releases, review the [Contributing guidelines](/CONTRIBUTING.md) |
| 11 | + |
| 12 | +## Overview |
| 13 | + |
| 14 | +This repository (https://github.com/nginx/documentation) is where we work by default. It has a one-way sync to an internal repository, used for closed content. |
| 15 | + |
| 16 | +You can get the URL through our internal communication channels: it will be represented in the following steps as `<closed-URL>`. |
| 17 | + |
| 18 | +To create closed content, first clone the internal repository: |
| 19 | + |
| 20 | +`git clone [email protected]:<closed-url>.git` |
| 21 | + |
| 22 | +Change into this new directory: |
| 23 | + |
| 24 | +`cd <closed-url>` |
| 25 | + |
| 26 | +Check out the `documentation` branch: |
| 27 | + |
| 28 | +`git checkout documentation` |
| 29 | + |
| 30 | +Create a feature branch, **ensuring that you prefix all branch names with `internal/`**: |
| 31 | + |
| 32 | +`git checkout -b internal/feature` |
| 33 | + |
| 34 | +You can then continue on as normal: |
| 35 | + |
| 36 | +```bash |
| 37 | +# Make documentation changes |
| 38 | +git add . |
| 39 | +git commit |
| 40 | +git push |
| 41 | +``` |
| 42 | + |
| 43 | +After you have iterated on the closed content, you can open a PR in the main repository by adding the closed repository as a remote. |
| 44 | + |
| 45 | +```bash |
| 46 | +git clone [email protected]:nginx/documentation.git |
| 47 | +cd documentation |
| 48 | +git add remote internal [email protected]: <closed-url >.git |
| 49 | +git fetch internal internal/feature |
| 50 | +git checkout -b feature |
| 51 | +git merge internal/internal/feature |
| 52 | +git push origin feature |
| 53 | +``` |
0 commit comments