summaryrefslogtreecommitdiff
path: root/CONTRIBUTING.md
blob: 496659bb9605d8214d84daf2db215c7bc359accd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
# Contributor's Guide

1. fork the project on GitHub https://github.com/vyos/vyos-documentation
2. clone the fork
3. create a a new branch for your work. You can use a name that describes what you do.
    ```shell
    git checkout -b fix-vxlan-typo
    ```
4. make your changes.

   Please check the documation, if you don't familiar with [sphinx-doc](http://http://www.sphinx-doc.org) or [reStructuredText](http://www.sphinx-doc.org/en/master/usage/restructuredtext/index.html)

   Note the following RFCs, which describe the reserved public IP addresses and autonomous system numbers for the documentation. [RFC5737](https://tools.ietf.org/html/rfc5737), [RFC3849](https://tools.ietf.org/html/rfc3849), [RFC5389](https://tools.ietf.org/html/rfc5398), [RFC7042](https://tools.ietf.org/html/rfc7042)

    * 192.0.2.0/24
    * 198.51.100.0/24
    * 203.0.113.0/24
    * 2001:db8::/32
    * 16bit ASN: 64496 - 64511
    * 32bit ASN: 65536 - 65551
    * Unicast MAC Addresses: 00-53-00 to 00-53-FF
    * Multicast MAC-Addresses: 90-10-00 to 90-10-FF

 Please don't use other public address space.


5. add the modified files
    ```shell
    git add path/to/filname
    ```
    or add all unstaged files
    ```shell
    git add .
    ````
6. commit your changes
    ```shell
    git commit -m "rename vxlan set syntax"
    ```
7. push your commits to your GitHub project:

    ```shell
    git push -u origin fix-vxlan-typo
    ```
8.  Submit a pull request.

    In GitHub, visit the main repository and you should see a banner
    suggesting to make a pull request. Fill out the form and describe what you do.