| ofs | hex dump | ascii |
|---|---|---|
| 0000 | de 12 04 95 00 00 00 00 7c 00 00 00 1c 00 00 00 fc 03 00 00 a7 00 00 00 dc 07 00 00 00 00 00 00 | ........|....................... |
| 0020 | 78 0a 00 00 1a 00 00 00 79 0a 00 00 1c 00 00 00 94 0a 00 00 1c 00 00 00 b1 0a 00 00 19 00 00 00 | x.......y....................... |
| 0040 | ce 0a 00 00 1c 00 00 00 e8 0a 00 00 0f 00 00 00 05 0b 00 00 0c 00 00 00 15 0b 00 00 97 00 00 00 | ................................ |
| 0060 | 22 0b 00 00 b4 00 00 00 ba 0b 00 00 0d 00 00 00 6f 0c 00 00 4a 00 00 00 7d 0c 00 00 d4 00 00 00 | "...............o...J...}....... |
| 0080 | c8 0c 00 00 a6 00 00 00 9d 0d 00 00 0d 00 00 00 44 0e 00 00 5e 00 00 00 52 0e 00 00 0a 00 00 00 | ................D...^...R....... |
| 00a0 | b1 0e 00 00 06 01 00 00 bc 0e 00 00 2a 00 00 00 c3 0f 00 00 56 00 00 00 ee 0f 00 00 01 01 00 00 | ............*.......V........... |
| 00c0 | 45 10 00 00 18 00 00 00 47 11 00 00 6b 00 00 00 60 11 00 00 10 00 00 00 cc 11 00 00 18 00 00 00 | E.......G...k...`............... |
| 00e0 | dd 11 00 00 aa 00 00 00 f6 11 00 00 9d 00 00 00 a1 12 00 00 2d 00 00 00 3f 13 00 00 3c 00 00 00 | ....................-...?...<... |
| 0100 | 6d 13 00 00 5c 00 00 00 aa 13 00 00 2b 00 00 00 07 14 00 00 7f 00 00 00 33 14 00 00 3b 00 00 00 | m...\.......+...........3...;... |
| 0120 | b3 14 00 00 38 00 00 00 ef 14 00 00 9e 00 00 00 28 15 00 00 0c 00 00 00 c7 15 00 00 4b 00 00 00 | ....8...........(...........K... |
| 0140 | d4 15 00 00 10 00 00 00 20 16 00 00 1a 00 00 00 31 16 00 00 1b 00 00 00 4c 16 00 00 53 00 00 00 | ................1.......L...S... |
| 0160 | 68 16 00 00 0a 00 00 00 bc 16 00 00 63 00 00 00 c7 16 00 00 5f 00 00 00 2b 17 00 00 5e 00 00 00 | h...........c......._...+...^... |
| 0180 | 8b 17 00 00 9d 00 00 00 ea 17 00 00 84 00 00 00 88 18 00 00 17 00 00 00 0d 19 00 00 55 00 00 00 | ............................U... |
| 01a0 | 25 19 00 00 2a 00 00 00 7b 19 00 00 2e 00 00 00 a6 19 00 00 0b 00 00 00 d5 19 00 00 90 01 00 00 | %...*...{....................... |
| 01c0 | e1 19 00 00 35 00 00 00 72 1b 00 00 b5 00 00 00 a8 1b 00 00 0e 01 00 00 5e 1c 00 00 85 00 00 00 | ....5...r...............^....... |
| 01e0 | 6d 1d 00 00 14 00 00 00 f3 1d 00 00 0c 00 00 00 08 1e 00 00 2d 00 00 00 15 1e 00 00 84 00 00 00 | m...................-........... |
| 0200 | 43 1e 00 00 51 00 00 00 c8 1e 00 00 4b 00 00 00 1a 1f 00 00 73 00 00 00 66 1f 00 00 d2 00 00 00 | C...Q.......K.......s...f....... |
| 0220 | da 1f 00 00 0b 00 00 00 ad 20 00 00 a3 00 00 00 b9 20 00 00 09 00 00 00 5d 21 00 00 68 00 00 00 | ........................]!..h... |
| 0240 | 67 21 00 00 59 01 00 00 d0 21 00 00 8e 00 00 00 2a 23 00 00 c6 00 00 00 b9 23 00 00 86 00 00 00 | g!..Y....!......*#.......#...... |
| 0260 | 80 24 00 00 ba 00 00 00 07 25 00 00 2e 00 00 00 c2 25 00 00 90 01 00 00 f1 25 00 00 a5 00 00 00 | .$.......%.......%.......%...... |
| 0280 | 82 27 00 00 54 00 00 00 28 28 00 00 7b 00 00 00 7d 28 00 00 24 00 00 00 f9 28 00 00 f1 00 00 00 | .'..T...((..{...}(..$....(...... |
| 02a0 | 1e 29 00 00 9c 00 00 00 10 2a 00 00 49 00 00 00 ad 2a 00 00 33 00 00 00 f7 2a 00 00 7b 00 00 00 | .).......*..I....*..3....*..{... |
| 02c0 | 2b 2b 00 00 86 00 00 00 a7 2b 00 00 27 00 00 00 2e 2c 00 00 a7 00 00 00 56 2c 00 00 37 01 00 00 | ++.......+..'....,......V,..7... |
| 02e0 | fe 2c 00 00 03 01 00 00 36 2e 00 00 b1 00 00 00 3a 2f 00 00 2a 00 00 00 ec 2f 00 00 f4 00 00 00 | .,......6.......:/..*..../...... |
| 0300 | 17 30 00 00 9c 00 00 00 0c 31 00 00 3a 00 00 00 a9 31 00 00 d7 00 00 00 e4 31 00 00 75 00 00 00 | .0.......1..:....1.......1..u... |
| 0320 | bc 32 00 00 7a 00 00 00 32 33 00 00 13 00 00 00 ad 33 00 00 93 00 00 00 c1 33 00 00 75 00 00 00 | .2..z...23.......3.......3..u... |
| 0340 | 55 34 00 00 9d 00 00 00 cb 34 00 00 10 00 00 00 69 35 00 00 13 00 00 00 7a 35 00 00 11 00 00 00 | U4.......4......i5......z5...... |
| 0360 | 8e 35 00 00 12 00 00 00 a0 35 00 00 40 00 00 00 b3 35 00 00 30 00 00 00 f4 35 00 00 39 00 00 00 | .5.......5..@....5..0....5..9... |
| 0380 | 25 36 00 00 45 00 00 00 5f 36 00 00 56 00 00 00 a5 36 00 00 06 00 00 00 fc 36 00 00 0a 00 00 00 | %6..E..._6..V....6.......6...... |
| 03a0 | 03 37 00 00 13 00 00 00 0e 37 00 00 50 00 00 00 22 37 00 00 44 00 00 00 73 37 00 00 3e 00 00 00 | .7.......7..P..."7..D...s7..>... |
| 03c0 | b8 37 00 00 05 00 00 00 f7 37 00 00 1d 00 00 00 fd 37 00 00 34 00 00 00 1b 38 00 00 30 00 00 00 | .7.......7.......7..4....8..0... |
| 03e0 | 50 38 00 00 06 00 00 00 81 38 00 00 3f 00 00 00 88 38 00 00 2b 00 00 00 c8 38 00 00 27 01 00 00 | P8.......8..?....8..+....8..'... |
| 0400 | f4 38 00 00 1a 00 00 00 1c 3a 00 00 1c 00 00 00 37 3a 00 00 1c 00 00 00 54 3a 00 00 19 00 00 00 | .8.......:......7:......T:...... |
| 0420 | 71 3a 00 00 1c 00 00 00 8b 3a 00 00 0f 00 00 00 a8 3a 00 00 0c 00 00 00 b8 3a 00 00 97 00 00 00 | q:.......:.......:.......:...... |
| 0440 | c5 3a 00 00 b4 00 00 00 5d 3b 00 00 0d 00 00 00 12 3c 00 00 4a 00 00 00 20 3c 00 00 d4 00 00 00 | .:......];.......<..J....<...... |
| 0460 | 6b 3c 00 00 a6 00 00 00 40 3d 00 00 0d 00 00 00 e7 3d 00 00 5e 00 00 00 f5 3d 00 00 0a 00 00 00 | k<......@=.......=..^....=...... |
| 0480 | 54 3e 00 00 06 01 00 00 5f 3e 00 00 2a 00 00 00 66 3f 00 00 56 00 00 00 91 3f 00 00 01 01 00 00 | T>......_>..*...f?..V....?...... |
| 04a0 | e8 3f 00 00 18 00 00 00 ea 40 00 00 6b 00 00 00 03 41 00 00 10 00 00 00 6f 41 00 00 18 00 00 00 | .?.......@..k....A......oA...... |
| 04c0 | 80 41 00 00 aa 00 00 00 99 41 00 00 9d 00 00 00 44 42 00 00 2d 00 00 00 e2 42 00 00 3c 00 00 00 | .A.......A......DB..-....B..<... |
| 04e0 | 10 43 00 00 5c 00 00 00 4d 43 00 00 2b 00 00 00 aa 43 00 00 7f 00 00 00 d6 43 00 00 3b 00 00 00 | .C..\...MC..+....C.......C..;... |
| 0500 | 56 44 00 00 38 00 00 00 92 44 00 00 9e 00 00 00 cb 44 00 00 0c 00 00 00 6a 45 00 00 4b 00 00 00 | VD..8....D.......D......jE..K... |
| 0520 | 77 45 00 00 10 00 00 00 c3 45 00 00 1a 00 00 00 d4 45 00 00 1b 00 00 00 ef 45 00 00 53 00 00 00 | wE.......E.......E.......E..S... |
| 0540 | 0b 46 00 00 0a 00 00 00 5f 46 00 00 63 00 00 00 6a 46 00 00 5f 00 00 00 ce 46 00 00 5e 00 00 00 | .F......_F..c...jF.._....F..^... |
| 0560 | 2e 47 00 00 9d 00 00 00 8d 47 00 00 84 00 00 00 2b 48 00 00 17 00 00 00 b0 48 00 00 55 00 00 00 | .G.......G......+H.......H..U... |
| 0580 | c8 48 00 00 2a 00 00 00 1e 49 00 00 2e 00 00 00 49 49 00 00 0b 00 00 00 78 49 00 00 90 01 00 00 | .H..*....I......II......xI...... |
| 05a0 | 84 49 00 00 35 00 00 00 15 4b 00 00 b5 00 00 00 4b 4b 00 00 0e 01 00 00 01 4c 00 00 85 00 00 00 | .I..5....K......KK.......L...... |
| 05c0 | 10 4d 00 00 14 00 00 00 96 4d 00 00 0c 00 00 00 ab 4d 00 00 2d 00 00 00 b8 4d 00 00 84 00 00 00 | .M.......M.......M..-....M...... |
| 05e0 | e6 4d 00 00 51 00 00 00 6b 4e 00 00 4b 00 00 00 bd 4e 00 00 73 00 00 00 09 4f 00 00 d2 00 00 00 | .M..Q...kN..K....N..s....O...... |
| 0600 | 7d 4f 00 00 0b 00 00 00 50 50 00 00 a3 00 00 00 5c 50 00 00 09 00 00 00 00 51 00 00 68 00 00 00 | }O......PP......\P.......Q..h... |
| 0620 | 0a 51 00 00 59 01 00 00 73 51 00 00 8e 00 00 00 cd 52 00 00 c6 00 00 00 5c 53 00 00 86 00 00 00 | .Q..Y...sQ.......R......\S...... |
| 0640 | 23 54 00 00 ba 00 00 00 aa 54 00 00 2e 00 00 00 65 55 00 00 90 01 00 00 94 55 00 00 a5 00 00 00 | #T.......T......eU.......U...... |
| 0660 | 25 57 00 00 54 00 00 00 cb 57 00 00 7b 00 00 00 20 58 00 00 24 00 00 00 9c 58 00 00 f1 00 00 00 | %W..T....W..{....X..$....X...... |
| 0680 | c1 58 00 00 9c 00 00 00 b3 59 00 00 49 00 00 00 50 5a 00 00 33 00 00 00 9a 5a 00 00 7b 00 00 00 | .X.......Y..I...PZ..3....Z..{... |
| 06a0 | ce 5a 00 00 86 00 00 00 4a 5b 00 00 27 00 00 00 d1 5b 00 00 a7 00 00 00 f9 5b 00 00 37 01 00 00 | .Z......J[..'....[.......[..7... |
| 06c0 | a1 5c 00 00 03 01 00 00 d9 5d 00 00 b1 00 00 00 dd 5e 00 00 2a 00 00 00 8f 5f 00 00 f4 00 00 00 | .\.......].......^..*...._...... |
| 06e0 | ba 5f 00 00 9c 00 00 00 af 60 00 00 3a 00 00 00 4c 61 00 00 d7 00 00 00 87 61 00 00 75 00 00 00 | ._.......`..:...La.......a..u... |
| 0700 | 5f 62 00 00 7a 00 00 00 d5 62 00 00 13 00 00 00 50 63 00 00 93 00 00 00 64 63 00 00 75 00 00 00 | _b..z....b......Pc......dc..u... |
| 0720 | f8 63 00 00 9d 00 00 00 6e 64 00 00 10 00 00 00 0c 65 00 00 13 00 00 00 1d 65 00 00 11 00 00 00 | .c......nd.......e.......e...... |
| 0740 | 31 65 00 00 12 00 00 00 43 65 00 00 40 00 00 00 56 65 00 00 30 00 00 00 97 65 00 00 39 00 00 00 | 1e......Ce..@...Ve..0....e..9... |
| 0760 | c8 65 00 00 45 00 00 00 02 66 00 00 56 00 00 00 48 66 00 00 06 00 00 00 9f 66 00 00 0a 00 00 00 | .e..E....f..V...Hf.......f...... |
| 0780 | a6 66 00 00 13 00 00 00 b1 66 00 00 50 00 00 00 c5 66 00 00 44 00 00 00 16 67 00 00 3e 00 00 00 | .f.......f..P....f..D....g..>... |
| 07a0 | 5b 67 00 00 05 00 00 00 9a 67 00 00 1d 00 00 00 a0 67 00 00 34 00 00 00 be 67 00 00 30 00 00 00 | [g.......g.......g..4....g..0... |
| 07c0 | f3 67 00 00 06 00 00 00 24 68 00 00 3f 00 00 00 2b 68 00 00 2b 00 00 00 6b 68 00 00 01 00 00 00 | .g......$h..?...+h..+...kh...... |
| 07e0 | 0f 00 00 00 51 00 00 00 00 00 00 00 00 00 00 00 34 00 00 00 00 00 00 00 00 00 00 00 3c 00 00 00 | ....Q...........4...........<... |
| 0800 | 00 00 00 00 06 00 00 00 2b 00 00 00 0a 00 00 00 53 00 00 00 00 00 00 00 5e 00 00 00 68 00 00 00 | ........+.......S.......^...h... |
| 0820 | 67 00 00 00 09 00 00 00 00 00 00 00 30 00 00 00 00 00 00 00 59 00 00 00 26 00 00 00 62 00 00 00 | g...........0.......Y...&...b... |
| 0840 | 37 00 00 00 0e 00 00 00 00 00 00 00 12 00 00 00 78 00 00 00 1a 00 00 00 17 00 00 00 00 00 00 00 | 7...............x............... |
| 0860 | 25 00 00 00 64 00 00 00 20 00 00 00 27 00 00 00 16 00 00 00 6f 00 00 00 00 00 00 00 00 00 00 00 | %...d.......'.......o........... |
| 0880 | 5a 00 00 00 73 00 00 00 5c 00 00 00 00 00 00 00 0d 00 00 00 00 00 00 00 54 00 00 00 63 00 00 00 | Z...s...\...............T...c... |
| 08a0 | 2d 00 00 00 00 00 00 00 29 00 00 00 00 00 00 00 76 00 00 00 00 00 00 00 57 00 00 00 00 00 00 00 | -.......).......v.......W....... |
| 08c0 | 00 00 00 00 6d 00 00 00 4f 00 00 00 7c 00 00 00 44 00 00 00 00 00 00 00 13 00 00 00 1e 00 00 00 | ....m...O...|...D............... |
| 08e0 | 3e 00 00 00 66 00 00 00 00 00 00 00 43 00 00 00 70 00 00 00 00 00 00 00 47 00 00 00 08 00 00 00 | >...f.......C...p.......G....... |
| 0900 | 04 00 00 00 4c 00 00 00 00 00 00 00 18 00 00 00 32 00 00 00 00 00 00 00 00 00 00 00 15 00 00 00 | ....L...........2............... |
| 0920 | 69 00 00 00 61 00 00 00 1c 00 00 00 6c 00 00 00 4d 00 00 00 3f 00 00 00 46 00 00 00 7b 00 00 00 | i...a.......l...M...?...F...{... |
| 0940 | 72 00 00 00 5f 00 00 00 4b 00 00 00 00 00 00 00 40 00 00 00 1f 00 00 00 23 00 00 00 75 00 00 00 | r..._...K.......@.......#...u... |
| 0960 | 55 00 00 00 41 00 00 00 77 00 00 00 00 00 00 00 71 00 00 00 24 00 00 00 39 00 00 00 05 00 00 00 | U...A...w.......q...$...9....... |
| 0980 | 03 00 00 00 7a 00 00 00 6a 00 00 00 4a 00 00 00 00 00 00 00 56 00 00 00 00 00 00 00 10 00 00 00 | ....z...j...J.......V........... |
| 09a0 | 36 00 00 00 35 00 00 00 6e 00 00 00 14 00 00 00 42 00 00 00 00 00 00 00 5d 00 00 00 00 00 00 00 | 6...5...n.......B.......]....... |
| 09c0 | 21 00 00 00 3a 00 00 00 00 00 00 00 31 00 00 00 0c 00 00 00 00 00 00 00 00 00 00 00 5b 00 00 00 | !...:.......1...............[... |
| 09e0 | 45 00 00 00 6b 00 00 00 48 00 00 00 0b 00 00 00 49 00 00 00 2f 00 00 00 2e 00 00 00 65 00 00 00 | E...k...H.......I.../.......e... |
| 0a00 | 07 00 00 00 02 00 00 00 2a 00 00 00 28 00 00 00 74 00 00 00 58 00 00 00 33 00 00 00 00 00 00 00 | ........*...(...t...X...3....... |
| 0a20 | 19 00 00 00 2c 00 00 00 60 00 00 00 79 00 00 00 1b 00 00 00 00 00 00 00 52 00 00 00 00 00 00 00 | ....,...`...y...........R....... |
| 0a40 | 00 00 00 00 22 00 00 00 11 00 00 00 00 00 00 00 3b 00 00 00 50 00 00 00 1d 00 00 00 00 00 00 00 | ...."...........;...P........... |
| 0a60 | 3d 00 00 00 00 00 00 00 38 00 00 00 00 00 00 00 4e 00 00 00 00 00 00 00 00 31 2e 20 54 68 65 6f | =.......8.......N........1..Theo |
| 0a80 | 72 65 74 69 63 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 00 31 36 62 69 74 20 41 53 4e 3a 20 60 | retical.information.16bit.ASN:.` |
| 0aa0 | 60 36 34 34 39 36 20 2d 20 36 34 35 31 31 60 60 00 32 2e 20 43 6f 6e 66 69 67 75 72 61 74 69 6f | `64496.-.64511``.2..Configuratio |
| 0ac0 | 6e 20 64 65 73 63 72 69 70 74 69 6f 6e 00 33 2e 20 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 65 | n.description.3..Configuration.e |
| 0ae0 | 78 61 6d 70 6c 65 73 00 33 32 62 69 74 20 41 53 4e 3a 20 60 60 36 35 35 33 36 20 2d 20 36 35 35 | xamples.32bit.ASN:.``65536.-.655 |
| 0b00 | 35 31 60 60 00 34 2e 20 4b 6e 6f 77 6e 20 69 73 73 75 65 73 00 35 2e 20 44 65 62 75 67 67 69 6e | 51``.4..Known.issues.5..Debuggin |
| 0b20 | 67 00 41 20 70 6c 75 67 69 6e 20 77 69 6c 6c 20 62 65 20 75 73 65 64 20 74 6f 20 67 65 6e 65 72 | g.A.plugin.will.be.used.to.gener |
| 0b40 | 61 74 65 20 61 20 72 65 66 65 72 65 6e 63 65 20 6c 61 62 65 6c 20 66 6f 72 20 65 61 63 68 20 68 | ate.a.reference.label.for.each.h |
| 0b60 | 65 61 64 6c 69 6e 65 2e 20 54 6f 20 72 65 66 65 72 65 6e 63 65 20 61 20 70 61 67 65 20 6f 72 20 | eadline..To.reference.a.page.or. |
| 0b80 | 61 20 73 65 63 74 69 6f 6e 20 69 6e 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 75 | a.section.in.the.documentation.u |
| 0ba0 | 73 65 20 74 68 65 20 60 60 3a 72 65 66 3a 60 60 20 63 6f 6d 6d 61 6e 64 2e 00 41 64 64 20 6d 6f | se.the.``:ref:``.command..Add.mo |
| 0bc0 | 64 69 66 69 65 64 20 66 69 6c 65 73 20 74 6f 20 47 69 74 20 69 6e 64 65 78 20 60 60 24 20 67 69 | dified.files.to.Git.index.``$.gi |
| 0be0 | 74 20 61 64 64 20 70 61 74 68 2f 74 6f 2f 66 69 6c 65 6e 61 6d 65 60 60 20 6f 72 20 61 64 64 20 | t.add.path/to/filename``.or.add. |
| 0c00 | 61 6c 6c 20 75 6e 73 74 61 67 65 64 20 66 69 6c 65 73 20 60 60 24 20 67 69 74 20 61 64 64 20 2e | all.unstaged.files.``$.git.add.. |
| 0c20 | 60 60 2e 20 41 6c 6c 20 66 69 6c 65 73 20 61 64 64 65 64 20 74 6f 20 74 68 65 20 47 69 74 20 69 | ``..All.files.added.to.the.Git.i |
| 0c40 | 6e 64 65 78 20 77 69 6c 6c 20 62 65 20 70 61 72 74 20 6f 66 20 79 6f 75 20 66 6f 6c 6c 6f 77 69 | ndex.will.be.part.of.you.followi |
| 0c60 | 6e 67 20 47 69 74 20 63 6f 6d 6d 69 74 2e 00 41 64 64 72 65 73 73 20 73 70 61 63 65 00 41 6c 6c | ng.Git.commit..Address.space.All |
| 0c80 | 20 52 53 54 20 66 69 6c 65 73 20 6d 75 73 74 20 66 6f 6c 6c 6f 77 20 74 68 65 20 73 61 6d 65 20 | .RST.files.must.follow.the.same. |
| 0ca0 | 54 4f 43 20 4c 65 76 65 6c 20 73 79 6e 74 61 78 20 61 6e 64 20 68 61 76 65 20 74 6f 20 73 74 61 | TOC.Level.syntax.and.have.to.sta |
| 0cc0 | 72 74 20 77 69 74 68 00 41 6e 20 6f 70 74 69 6f 6e 61 6c 20 73 65 63 74 69 6f 6e 20 66 6f 6c 6c | rt.with.An.optional.section.foll |
| 0ce0 | 6f 77 73 2e 20 53 6f 6d 65 20 63 6f 6d 6d 61 6e 64 73 20 68 61 76 65 20 72 65 71 75 69 72 65 6d | ows..Some.commands.have.requirem |
| 0d00 | 65 6e 74 73 20 6c 69 6b 65 20 63 6f 6d 70 61 74 69 62 6c 65 20 68 61 72 64 77 61 72 65 20 28 65 | ents.like.compatible.hardware.(e |
| 0d20 | 2e 67 2e 20 57 69 66 69 29 20 6f 72 20 73 6f 6d 65 20 63 6f 6d 6d 61 6e 64 73 20 79 6f 75 20 68 | .g..Wifi).or.some.commands.you.h |
| 0d40 | 61 76 65 20 74 6f 20 73 65 74 20 62 65 66 6f 72 65 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 | ave.to.set.before..For.example,. |
| 0d60 | 69 74 20 69 73 20 72 65 63 6f 6d 6d 65 6e 64 65 64 20 74 6f 20 73 65 74 20 61 20 72 6f 75 74 65 | it.is.recommended.to.set.a.route |
| 0d80 | 2d 6d 61 70 20 62 65 66 6f 72 65 20 63 6f 6e 66 69 67 75 72 69 6e 67 20 42 47 50 2e 00 41 6e 64 | -map.before.configuring.BGP..And |
| 0da0 | 20 66 69 6e 61 6c 6c 79 2c 20 72 65 6d 65 6d 62 65 72 20 74 68 61 74 20 74 68 65 20 72 65 53 74 | .finally,.remember.that.the.reSt |
| 0dc0 | 72 75 63 74 75 72 65 64 54 65 78 74 20 66 69 6c 65 73 20 61 72 65 6e 27 74 20 65 78 63 6c 75 73 | ructuredText.files.aren't.exclus |
| 0de0 | 69 76 65 6c 79 20 66 6f 72 20 67 65 6e 65 72 61 74 69 6e 67 20 48 54 4d 4c 20 61 6e 64 20 50 44 | ively.for.generating.HTML.and.PD |
| 0e00 | 46 2e 20 54 68 65 79 20 73 68 6f 75 6c 64 20 62 65 20 68 75 6d 61 6e 2d 72 65 61 64 61 62 6c 65 | F..They.should.be.human-readable |
| 0e20 | 20 61 6e 64 20 65 61 73 69 6c 79 20 70 65 72 75 73 65 64 20 66 72 6f 6d 20 61 20 63 6f 6e 73 6f | .and.easily.perused.from.a.conso |
| 0e40 | 6c 65 2e 00 41 6e 79 74 68 69 6e 67 20 65 6c 73 65 00 41 6e 79 74 68 69 6e 67 20 65 6c 73 65 20 | le..Anything.else.Anything.else. |
| 0e60 | 74 68 61 74 20 69 73 20 6e 6f 74 20 61 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6f 72 20 61 | that.is.not.a.configuration.or.a |
| 0e80 | 6e 20 6f 70 65 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 20 68 61 73 20 6e 6f 20 70 72 65 64 65 | n.operation.command.has.no.prede |
| 0ea0 | 66 69 6e 65 64 20 73 74 72 75 63 74 75 72 65 2e 00 41 75 74 6f 6c 69 6e 74 65 72 00 43 68 65 63 | fined.structure..Autolinter.Chec |
| 0ec0 | 6b 20 79 6f 75 72 20 63 68 61 6e 67 65 73 20 62 79 20 6c 6f 63 61 6c 6c 79 20 62 75 69 6c 64 69 | k.your.changes.by.locally.buildi |
| 0ee0 | 6e 67 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 60 60 24 20 6d 61 6b 65 20 6c 69 | ng.the.documentation.``$.make.li |
| 0f00 | 76 65 68 74 6d 6c 60 60 2e 20 53 70 68 69 6e 78 20 77 69 6c 6c 20 62 75 69 6c 64 20 74 68 65 20 | vehtml``..Sphinx.will.build.the. |
| 0f20 | 68 74 6d 6c 20 66 69 6c 65 73 20 69 6e 20 74 68 65 20 60 60 64 6f 63 73 2f 5f 62 75 69 6c 64 60 | html.files.in.the.``docs/_build` |
| 0f40 | 60 20 66 6f 6c 64 65 72 2e 20 57 65 20 70 72 6f 76 69 64 65 20 79 6f 75 20 77 69 74 68 20 61 20 | `.folder..We.provide.you.with.a. |
| 0f60 | 44 6f 63 6b 65 72 20 63 6f 6e 74 61 69 6e 65 72 20 66 6f 72 20 61 6e 20 65 61 73 79 2d 74 6f 2d | Docker.container.for.an.easy-to- |
| 0f80 | 75 73 65 20 75 73 65 72 20 65 78 70 65 72 69 65 6e 63 65 2e 20 43 68 65 63 6b 20 74 68 65 20 52 | use.user.experience..Check.the.R |
| 0fa0 | 45 41 44 4d 45 2e 6d 64 5f 20 66 69 6c 65 20 6f 66 20 74 68 69 73 20 72 65 70 6f 73 69 74 6f 72 | EADME.md_.file.of.this.repositor |
| 0fc0 | 79 2e 00 43 68 65 63 6b 20 79 6f 75 72 20 63 6f 6e 66 69 67 75 72 65 64 20 72 65 6d 6f 74 65 20 | y..Check.your.configured.remote. |
| 0fe0 | 72 65 70 6f 73 69 74 6f 72 69 65 73 3a 00 43 6c 6f 6e 65 20 66 6f 72 6b 20 74 6f 20 6c 6f 63 61 | repositories:.Clone.fork.to.loca |
| 1000 | 6c 20 6d 61 63 68 69 6e 65 2c 20 74 68 65 6e 20 63 68 61 6e 67 65 20 74 6f 20 74 68 61 74 20 64 | l.machine,.then.change.to.that.d |
| 1020 | 69 72 65 63 74 6f 72 79 20 60 60 24 20 63 64 20 76 79 6f 73 2d 64 6f 63 75 6d 65 6e 74 61 74 69 | irectory.``$.cd.vyos-documentati |
| 1040 | 6f 6e 60 60 00 43 6f 6d 6d 69 74 20 79 6f 75 72 20 63 68 61 6e 67 65 73 20 77 69 74 68 20 74 68 | on``.Commit.your.changes.with.th |
| 1060 | 65 20 6d 65 73 73 61 67 65 2c 20 60 60 24 20 67 69 74 20 63 6f 6d 6d 69 74 20 2d 6d 20 22 3c 63 | e.message,.``$.git.commit.-m."<c |
| 1080 | 6f 6d 6d 69 74 20 6d 65 73 73 61 67 65 3e 22 60 60 20 6f 72 20 20 75 73 65 20 60 60 24 20 67 69 | ommit.message>"``.or..use.``$.gi |
| 10a0 | 74 20 63 6f 6d 6d 69 74 20 2d 76 60 60 20 74 6f 20 68 61 76 65 20 79 6f 75 72 20 63 6f 6e 66 69 | t.commit.-v``.to.have.your.confi |
| 10c0 | 67 75 72 65 64 20 65 64 69 74 6f 72 20 6c 61 75 6e 63 68 65 64 2e 20 59 6f 75 20 63 61 6e 20 74 | gured.editor.launched..You.can.t |
| 10e0 | 79 70 65 20 69 6e 20 61 20 63 6f 6d 6d 69 74 20 6d 65 73 73 61 67 65 2e 20 41 67 61 69 6e 20 70 | ype.in.a.commit.message..Again.p |
| 1100 | 6c 65 61 73 65 20 6d 61 6b 65 20 79 6f 75 72 73 65 6c 66 20 63 6f 6d 66 6f 72 74 61 62 6c 65 20 | lease.make.yourself.comfortable. |
| 1120 | 77 69 74 68 6f 75 74 20 72 75 6c 65 73 20 28 3a 72 65 66 3a 60 70 72 65 70 61 72 65 5f 63 6f 6d | without.rules.(:ref:`prepare_com |
| 1140 | 6d 69 74 60 29 2e 00 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6d 6f 64 65 20 70 61 67 65 73 00 | mit`)..Configuration.mode.pages. |
| 1160 | 43 72 65 61 74 65 20 61 20 6e 65 77 20 62 72 61 6e 63 68 20 66 6f 72 20 79 6f 75 72 20 77 6f 72 | Create.a.new.branch.for.your.wor |
| 1180 | 6b 2c 20 75 73 65 20 61 20 64 65 73 63 72 69 70 74 69 76 65 20 6e 61 6d 65 20 6f 66 20 79 6f 75 | k,.use.a.descriptive.name.of.you |
| 11a0 | 72 20 77 6f 72 6b 3a 20 60 60 24 20 67 69 74 20 63 68 65 63 6b 6f 75 74 20 2d 62 20 3c 62 72 61 | r.work:.``$.git.checkout.-b.<bra |
| 11c0 | 6e 63 68 2d 6e 61 6d 65 3e 60 60 00 43 72 6f 73 73 2d 52 65 66 65 72 65 6e 63 65 73 00 43 75 73 | nch-name>``.Cross-References.Cus |
| 11e0 | 74 6f 6d 20 53 70 68 69 6e 78 2d 64 6f 63 20 4d 61 72 6b 75 70 00 43 75 73 74 6f 6d 20 63 6f 6d | tom.Sphinx-doc.Markup.Custom.com |
| 1200 | 6d 61 6e 64 73 20 68 61 76 65 20 62 65 65 6e 20 64 65 76 65 6c 6f 70 65 64 20 66 6f 72 20 77 72 | mands.have.been.developed.for.wr |
| 1220 | 69 74 69 6e 67 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2e 20 50 6c 65 61 73 65 20 | iting.the.documentation..Please. |
| 1240 | 6d 61 6b 65 20 79 6f 75 72 73 65 6c 66 20 63 6f 6d 66 6f 72 74 61 62 6c 65 20 77 69 74 68 20 74 | make.yourself.comfortable.with.t |
| 1260 | 68 6f 73 65 20 63 6f 6d 6d 61 6e 64 73 20 61 73 20 74 68 69 73 20 65 61 73 65 73 20 74 68 65 20 | hose.commands.as.this.eases.the. |
| 1280 | 77 61 79 20 77 65 20 72 65 6e 64 65 72 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2e | way.we.render.the.documentation. |
| 12a0 | 00 44 65 73 63 72 69 62 65 20 43 4c 49 20 69 74 65 6d 73 20 72 65 6c 61 74 65 64 20 74 6f 20 74 | .Describe.CLI.items.related.to.t |
| 12c0 | 68 65 20 73 65 72 76 69 63 65 20 6f 72 20 75 73 65 20 63 61 73 65 2e 20 45 61 63 68 20 63 6f 6e | he.service.or.use.case..Each.con |
| 12e0 | 66 69 67 20 6c 69 6e 65 20 6f 72 20 73 65 63 74 69 6f 6e 20 6d 75 73 74 20 62 65 20 65 78 70 6c | fig.line.or.section.must.be.expl |
| 1300 | 61 69 6e 65 64 2c 20 75 73 69 6e 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 70 72 6f 76 69 64 65 | ained,.using.information.provide |
| 1320 | 64 20 69 6e 20 74 68 65 20 31 73 74 20 70 61 72 74 20 6f 66 20 74 68 65 20 70 61 67 65 2e 00 44 | d.in.the.1st.part.of.the.page..D |
| 1340 | 65 73 63 72 69 62 65 64 20 70 72 6f 63 65 64 75 72 65 73 20 66 6f 72 20 64 65 62 75 67 67 69 6e | escribed.procedures.for.debuggin |
| 1360 | 67 20 61 20 73 65 72 76 69 63 65 3a 00 44 6f 6e 27 74 20 66 6f 72 67 65 74 20 74 6f 20 75 70 64 | g.a.service:.Don't.forget.to.upd |
| 1380 | 61 74 65 20 60 60 69 6e 64 65 78 2e 72 73 74 60 60 20 77 68 65 6e 20 61 64 64 69 6e 67 20 61 20 | ate.``index.rst``.when.adding.a. |
| 13a0 | 6e 65 77 20 6e 6f 64 65 2e 00 45 61 63 68 20 47 69 74 48 75 62 20 70 75 6c 6c 20 72 65 71 75 65 | new.node..Each.GitHub.pull.reque |
| 13c0 | 73 74 20 69 73 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 6c 69 6e 74 65 64 20 74 6f 20 63 68 | st.is.automatically.linted.to.ch |
| 13e0 | 65 63 6b 20 74 68 65 20 61 64 64 72 65 73 73 20 73 70 61 63 65 20 61 6e 64 20 6c 69 6e 65 20 6c | eck.the.address.space.and.line.l |
| 1400 | 65 6e 67 74 68 2e 00 45 61 63 68 20 70 61 67 65 20 6d 75 73 74 20 63 6f 6e 74 61 69 6e 20 74 68 | ength..Each.page.must.contain.th |
| 1420 | 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 70 61 72 74 73 3a 00 45 78 63 65 70 74 20 69 6e 20 60 60 2e | e.following.parts:.Except.in.``. |
| 1440 | 2e 20 63 6f 64 65 2d 62 6c 6f 63 6b 3a 3a 60 60 20 62 65 63 61 75 73 65 20 69 74 20 75 73 65 73 | ..code-block::``.because.it.uses |
| 1460 | 20 74 68 65 20 68 74 6d 6c 20 74 61 67 20 60 60 3c 70 72 65 3e 60 60 20 61 6e 64 20 72 65 6e 64 | .the.html.tag.``<pre>``.and.rend |
| 1480 | 65 72 73 20 74 68 65 20 73 61 6d 65 20 6c 69 6e 65 20 66 6f 72 6d 61 74 20 66 72 6f 6d 20 74 68 | ers.the.same.line.format.from.th |
| 14a0 | 65 20 73 6f 75 72 63 65 20 72 73 74 20 66 69 6c 65 2e 00 46 6f 72 20 61 6e 20 69 6e 6c 69 6e 65 | e.source.rst.file..For.an.inline |
| 14c0 | 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6c 65 76 65 6c 20 63 6f 6d 6d 61 6e 64 2c 20 75 73 | .configuration.level.command,.us |
| 14e0 | 65 20 60 60 3a 63 66 67 63 6d 64 3a 60 60 00 46 6f 72 20 61 6e 20 69 6e 6c 69 6e 65 20 6f 70 65 | e.``:cfgcmd:``.For.an.inline.ope |
| 1500 | 72 61 74 69 6f 6e 61 6c 20 6c 65 76 65 6c 20 63 6f 6d 6d 61 6e 64 2c 20 75 73 65 20 60 60 3a 6f | rational.level.command,.use.``:o |
| 1520 | 70 63 6d 64 3a 60 60 00 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 79 6f 75 20 77 61 6e 74 20 74 6f | pcmd:``.For.example,.you.want.to |
| 1540 | 20 72 65 66 65 72 65 6e 63 65 20 74 68 65 20 68 65 61 64 6c 69 6e 65 20 2a 2a 56 4c 41 4e 2a 2a | .reference.the.headline.**VLAN** |
| 1560 | 20 69 6e 20 74 68 65 20 2a 2a 65 74 68 65 72 6e 65 74 2e 72 73 74 2a 2a 20 70 61 67 65 2e 20 54 | .in.the.**ethernet.rst**.page..T |
| 1580 | 68 65 20 70 6c 75 67 69 6e 20 67 65 6e 65 72 61 74 65 73 20 74 68 65 20 6c 61 62 65 6c 20 62 61 | he.plugin.generates.the.label.ba |
| 15a0 | 73 65 64 20 6f 6e 20 74 68 65 20 68 65 61 64 6c 69 6e 65 20 61 6e 64 20 74 68 65 20 66 69 6c 65 | sed.on.the.headline.and.the.file |
| 15c0 | 20 70 61 74 68 2e 00 46 6f 72 20 65 78 61 6d 70 6c 65 3a 00 46 6f 72 6b 20 74 68 69 73 20 70 72 | .path..For.example:.Fork.this.pr |
| 15e0 | 6f 6a 65 63 74 20 6f 6e 20 47 69 74 48 75 62 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 | oject.on.GitHub.https://github.c |
| 1600 | 6f 6d 2f 76 79 6f 73 2f 76 79 6f 73 2d 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2f 66 6f 72 6b 00 | om/vyos/vyos-documentation/fork. |
| 1620 | 46 6f 72 6b 69 6e 67 20 57 6f 72 6b 66 6c 6f 77 00 46 6f 72 6d 61 74 69 6e 67 20 61 6e 64 20 53 | Forking.Workflow.Formating.and.S |
| 1640 | 70 68 69 6e 78 6d 61 72 6b 75 70 00 46 6f 72 6d 61 74 74 69 6e 67 20 61 6e 64 20 53 70 68 69 6e | phinxmarkup.Formatting.and.Sphin |
| 1660 | 78 6d 61 72 6b 75 70 00 47 65 6e 65 72 61 6c 20 63 6f 6e 63 65 70 74 73 20 66 6f 72 20 74 72 6f | xmarkup.General.concepts.for.tro |
| 1680 | 75 62 6c 65 73 68 6f 6f 74 69 6e 67 20 61 6e 64 20 64 65 74 61 69 6c 65 64 20 70 72 6f 63 65 73 | ubleshooting.and.detailed.proces |
| 16a0 | 73 20 64 65 73 63 72 69 70 74 69 6f 6e 73 20 62 65 6c 6f 6e 67 20 68 65 72 65 2e 00 47 75 69 64 | s.descriptions.belong.here..Guid |
| 16c0 | 65 6c 69 6e 65 73 00 49 66 20 74 68 65 72 65 20 73 6f 6d 65 20 74 72 6f 75 62 6c 65 73 68 6f 6f | elines.If.there.some.troubleshoo |
| 16e0 | 74 69 6e 67 20 67 75 69 64 65 73 20 72 65 6c 61 74 65 64 20 74 6f 20 74 68 65 20 63 6f 6d 6d 61 | ting.guides.related.to.the.comma |
| 1700 | 6e 64 73 2e 20 45 78 70 6c 61 69 6e 20 69 74 20 69 6e 20 74 68 65 20 6e 65 78 74 20 6f 70 74 69 | nds..Explain.it.in.the.next.opti |
| 1720 | 6f 6e 61 6c 20 70 61 72 74 2e 00 49 66 20 79 6f 75 20 61 6c 73 6f 20 77 61 6e 74 20 74 6f 20 75 | onal.part..If.you.also.want.to.u |
| 1740 | 70 64 61 74 65 20 79 6f 75 72 20 66 6f 72 6b 20 6f 6e 20 47 69 74 48 75 62 2c 20 75 73 65 20 74 | pdate.your.fork.on.GitHub,.use.t |
| 1760 | 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 3a 20 60 60 24 20 67 69 74 20 70 75 73 68 20 6f 72 69 67 69 | he.following:.``$.git.push.origi |
| 1780 | 6e 20 6d 61 73 74 65 72 60 60 00 49 66 20 79 6f 75 20 61 72 65 20 77 69 6c 6c 69 6e 67 20 74 6f | n.master``.If.you.are.willing.to |
| 17a0 | 20 63 6f 6e 74 72 69 62 75 74 65 20 74 6f 20 6f 75 72 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e | .contribute.to.our.documentation |
| 17c0 | 20 74 68 69 73 20 69 73 20 74 68 65 20 64 65 66 69 6e 69 74 65 20 67 75 69 64 65 20 68 6f 77 20 | .this.is.the.definite.guide.how. |
| 17e0 | 74 6f 20 64 6f 20 73 6f 2e 00 49 6e 20 63 6f 6e 74 72 61 73 74 20 74 6f 20 73 75 62 6d 69 74 74 | to.do.so..In.contrast.to.submitt |
| 1800 | 69 6e 67 20 63 6f 64 65 20 70 61 74 63 68 65 73 2c 20 74 68 65 72 65 20 69 73 20 6e 6f 20 72 65 | ing.code.patches,.there.is.no.re |
| 1820 | 71 75 69 72 65 6d 65 6e 74 20 74 68 61 74 20 79 6f 75 20 6f 70 65 6e 20 75 70 20 61 20 50 68 61 | quirement.that.you.open.up.a.Pha |
| 1840 | 62 72 69 63 61 74 6f 72 5f 20 74 61 73 6b 20 70 72 69 6f 72 20 74 6f 20 73 75 62 6d 69 74 74 69 | bricator_.task.prior.to.submitti |
| 1860 | 6e 67 20 61 20 50 75 6c 6c 2d 52 65 71 75 65 73 74 20 74 6f 20 74 68 65 20 64 6f 63 75 6d 65 6e | ng.a.Pull-Request.to.the.documen |
| 1880 | 74 61 74 69 6f 6e 2e 00 49 6e 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 70 61 72 | tation..In.the.configuration.par |
| 18a0 | 74 20 6f 66 20 74 68 65 20 70 61 67 65 2c 20 61 6c 6c 20 70 6f 73 73 69 62 6c 65 20 63 6f 6e 66 | t.of.the.page,.all.possible.conf |
| 18c0 | 69 67 75 72 61 74 69 6f 6e 20 6f 70 74 69 6f 6e 73 20 73 68 6f 75 6c 64 20 62 65 20 64 6f 63 75 | iguration.options.should.be.docu |
| 18e0 | 6d 65 6e 74 65 64 2e 20 55 73 65 20 60 60 2e 2e 20 63 66 67 63 6d 64 3a 3a 60 60 20 64 65 73 63 | mented..Use.``...cfgcmd::``.desc |
| 1900 | 72 69 62 65 64 20 61 62 6f 76 65 2e 00 49 6e 64 65 6e 74 20 77 69 74 68 20 74 77 6f 20 73 70 61 | ribed.above..Indent.with.two.spa |
| 1920 | 63 65 73 2e 00 49 6e 73 74 61 6c 6c 20 74 68 65 20 72 65 71 75 69 72 65 6d 65 6e 74 73 20 60 60 | ces..Install.the.requirements.`` |
| 1940 | 24 20 70 69 70 20 69 6e 73 74 61 6c 6c 20 2d 72 20 72 65 71 75 69 72 65 6d 65 6e 74 73 2e 74 78 | $.pip.install.-r.requirements.tx |
| 1960 | 74 60 60 20 28 6f 72 20 73 6f 6d 65 74 68 69 6e 67 20 73 69 6d 69 6c 61 72 29 00 4c 65 61 76 65 | t``.(or.something.similar).Leave |
| 1980 | 20 61 20 6e 65 77 6c 69 6e 65 20 62 65 66 6f 72 65 20 61 6e 64 20 61 66 74 65 72 20 61 20 68 65 | .a.newline.before.and.after.a.he |
| 19a0 | 61 64 65 72 2e 00 4c 69 6d 69 74 20 61 6c 6c 20 6c 69 6e 65 73 20 74 6f 20 61 20 6d 61 78 69 6d | ader..Limit.all.lines.to.a.maxim |
| 19c0 | 75 6d 20 6f 66 20 38 30 20 63 68 61 72 61 63 74 65 72 73 2e 00 4c 69 6e 65 20 6c 65 6e 67 74 68 | um.of.80.characters..Line.length |
| 19e0 | 00 4d 61 6b 65 20 61 6c 6c 20 79 6f 75 72 20 63 68 61 6e 67 65 73 20 2d 20 70 6c 65 61 73 65 20 | .Make.all.your.changes.-.please. |
| 1a00 | 6b 65 65 70 20 6f 75 72 20 63 6f 6d 6d 69 74 20 72 75 6c 65 73 20 69 6e 20 6d 69 6e 64 20 28 3a | keep.our.commit.rules.in.mind.(: |
| 1a20 | 72 65 66 3a 60 70 72 65 70 61 72 65 5f 63 6f 6d 6d 69 74 60 29 2e 20 54 68 69 73 20 6d 61 69 6e | ref:`prepare_commit`)..This.main |
| 1a40 | 6c 79 20 61 70 70 6c 69 65 73 20 74 6f 20 70 72 6f 70 65 72 20 63 6f 6d 6d 69 74 20 6d 65 73 73 | ly.applies.to.proper.commit.mess |
| 1a60 | 61 67 65 73 20 64 65 73 63 72 69 62 69 6e 67 20 79 6f 75 72 20 63 68 61 6e 67 65 20 28 68 6f 77 | ages.describing.your.change.(how |
| 1a80 | 20 61 6e 64 20 77 68 79 29 2e 20 50 6c 65 61 73 65 20 63 68 65 63 6b 20 6f 75 74 20 74 68 65 20 | .and.why)..Please.check.out.the. |
| 1aa0 | 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 53 70 68 69 6e 78 2d 64 6f 63 5f 20 6f 72 20 | documentation.of.Sphinx-doc_.or. |
| 1ac0 | 72 65 53 74 72 75 63 74 75 72 65 64 54 65 78 74 5f 20 69 66 20 79 6f 75 20 61 72 65 20 6e 6f 74 | reStructuredText_.if.you.are.not |
| 1ae0 | 20 66 61 6d 69 6c 69 61 72 20 77 69 74 68 20 69 74 2e 20 54 68 69 73 20 69 73 20 75 73 65 64 20 | .familiar.with.it..This.is.used. |
| 1b00 | 66 6f 72 20 77 72 69 74 69 6e 67 20 6f 75 72 20 64 6f 63 73 2e 20 41 64 64 69 74 69 6f 6e 61 6c | for.writing.our.docs..Additional |
| 1b20 | 20 64 69 72 65 63 74 69 76 65 73 20 68 6f 77 20 74 6f 20 77 72 69 74 65 20 69 6e 20 52 53 54 20 | .directives.how.to.write.in.RST. |
| 1b40 | 63 61 6e 20 62 65 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 72 65 53 74 72 75 63 74 75 72 65 | can.be.obtained.from.reStructure |
| 1b60 | 64 54 65 78 74 44 69 72 65 63 74 69 76 65 73 5f 2e 00 4d 75 6c 74 69 63 61 73 74 20 4d 41 43 2d | dTextDirectives_..Multicast.MAC- |
| 1b80 | 41 64 64 72 65 73 73 65 73 3a 20 60 60 39 30 2d 31 30 2d 30 30 60 60 20 74 6f 20 60 60 39 30 2d | Addresses:.``90-10-00``.to.``90- |
| 1ba0 | 31 30 2d 46 46 60 60 00 4e 6f 74 65 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 52 46 43 73 20 | 10-FF``.Note.the.following.RFCs. |
| 1bc0 | 28 3a 72 66 63 3a 60 35 37 33 37 60 2c 20 3a 72 66 63 3a 60 33 38 34 39 60 2c 20 3a 72 66 63 3a | (:rfc:`5737`,.:rfc:`3849`,.:rfc: |
| 1be0 | 60 35 33 38 39 60 20 61 6e 64 20 3a 72 66 63 3a 60 37 30 34 32 60 29 2c 20 77 68 69 63 68 20 64 | `5389`.and.:rfc:`7042`),.which.d |
| 1c00 | 65 73 63 72 69 62 65 20 74 68 65 20 72 65 73 65 72 76 65 64 20 70 75 62 6c 69 63 20 49 50 20 61 | escribe.the.reserved.public.IP.a |
| 1c20 | 64 64 72 65 73 73 65 73 20 61 6e 64 20 61 75 74 6f 6e 6f 6d 6f 75 73 20 73 79 73 74 65 6d 20 6e | ddresses.and.autonomous.system.n |
| 1c40 | 75 6d 62 65 72 73 20 66 6f 72 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 3a 00 4f 6e | umbers.for.the.documentation:.On |
| 1c60 | 63 65 20 70 75 6c 6c 20 72 65 71 75 65 73 74 73 20 68 61 76 65 20 62 65 65 6e 20 61 70 70 72 6f | ce.pull.requests.have.been.appro |
| 1c80 | 76 65 64 2c 20 79 6f 75 20 6d 61 79 20 77 61 6e 74 20 74 6f 20 6c 6f 63 61 6c 6c 79 20 75 70 64 | ved,.you.may.want.to.locally.upd |
| 1ca0 | 61 74 65 20 79 6f 75 72 20 66 6f 72 6b 65 64 20 72 65 70 6f 73 69 74 6f 72 79 20 74 6f 6f 2e 20 | ate.your.forked.repository.too.. |
| 1cc0 | 46 69 72 73 74 20 79 6f 75 27 6c 6c 20 68 61 76 65 20 74 6f 20 61 64 64 20 61 20 73 65 63 6f 6e | First.you'll.have.to.add.a.secon |
| 1ce0 | 64 20 72 65 6d 6f 74 65 20 63 61 6c 6c 65 64 20 60 75 70 73 74 72 65 61 6d 60 20 77 68 69 63 68 | d.remote.called.`upstream`.which |
| 1d00 | 20 70 6f 69 6e 74 73 20 74 6f 20 6f 75 72 20 6d 61 69 6e 20 72 65 70 6f 73 69 74 6f 72 79 2e 20 | .points.to.our.main.repository.. |
| 1d20 | 60 60 24 20 67 69 74 20 72 65 6d 6f 74 65 20 61 64 64 20 75 70 73 74 72 65 61 6d 20 68 74 74 70 | ``$.git.remote.add.upstream.http |
| 1d40 | 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 76 79 6f 73 2f 76 79 6f 73 2d 64 6f 63 75 6d 65 6e | s://github.com/vyos/vyos-documen |
| 1d60 | 74 61 74 69 6f 6e 2e 67 69 74 60 60 00 4f 70 65 72 61 74 69 6f 6e 20 6d 6f 64 65 20 63 6f 6d 6d | tation.git``.Operation.mode.comm |
| 1d80 | 61 6e 64 73 20 74 68 61 74 20 64 6f 20 6e 6f 74 20 66 69 74 20 69 6e 20 61 20 72 65 6c 61 74 65 | ands.that.do.not.fit.in.a.relate |
| 1da0 | 64 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6d 6f 64 65 20 63 6f 6d 6d 61 6e 64 20 6d 75 73 | d.configuration.mode.command.mus |
| 1dc0 | 74 20 62 65 20 64 6f 63 75 6d 65 6e 74 65 64 20 69 6e 20 74 68 69 73 20 70 61 72 74 20 6f 66 20 | t.be.documented.in.this.part.of. |
| 1de0 | 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2e 00 4f 70 65 72 61 74 69 6f 6e 20 6d 6f 64 | the.documentation..Operation.mod |
| 1e00 | 65 20 70 61 67 65 73 00 50 61 67 65 20 63 6f 6e 74 65 6e 74 00 50 6c 65 61 73 65 20 64 6f 20 6e | e.pages.Page.content.Please.do.n |
| 1e20 | 6f 74 20 75 73 65 20 6f 74 68 65 72 20 70 75 62 6c 69 63 20 61 64 64 72 65 73 73 20 73 70 61 63 | ot.use.other.public.address.spac |
| 1e40 | 65 2e 00 50 72 61 63 74 69 63 61 6c 20 65 78 61 6d 70 6c 65 73 20 6f 66 20 74 68 65 20 73 65 72 | e..Practical.examples.of.the.ser |
| 1e60 | 76 69 63 65 20 6f 72 20 75 73 65 20 63 61 73 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e 20 | vice.or.use.case.configuration.. |
| 1e80 | 54 68 65 79 20 6d 75 73 74 20 63 6f 6e 74 61 69 6e 20 74 6f 70 6f 6c 6f 67 79 20 6d 61 70 73 20 | They.must.contain.topology.maps. |
| 1ea0 | 28 69 66 20 61 70 70 6c 69 63 61 62 6c 65 29 20 61 6e 64 20 73 68 6f 72 74 20 64 65 73 63 72 69 | (if.applicable).and.short.descri |
| 1ec0 | 70 74 69 6f 6e 73 2e 00 50 72 6f 70 65 72 6c 79 20 71 75 6f 74 65 20 63 6f 6d 6d 61 6e 64 73 2c | ptions..Properly.quote.commands, |
| 1ee0 | 20 66 69 6c 65 6e 61 6d 65 73 20 61 6e 64 20 62 72 69 65 66 20 63 6f 64 65 20 73 6e 69 70 70 65 | .filenames.and.brief.code.snippe |
| 1f00 | 74 73 20 77 69 74 68 20 64 6f 75 62 6c 65 20 62 61 63 6b 74 69 63 6b 73 2e 00 50 75 73 68 20 63 | ts.with.double.backticks..Push.c |
| 1f20 | 6f 6d 6d 69 74 73 20 74 6f 20 79 6f 75 72 20 47 69 74 48 75 62 20 70 72 6f 6a 65 63 74 3a 20 60 | ommits.to.your.GitHub.project:.` |
| 1f40 | 60 24 20 67 69 74 20 70 75 73 68 20 2d 75 20 6f 72 69 67 69 6e 20 3c 62 72 61 6e 63 68 2d 6e 61 | `$.git.push.-u.origin.<branch-na |
| 1f60 | 6d 65 3e 60 60 00 52 65 6c 61 74 65 64 20 6f 70 65 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 20 | me>``.Related.operation.command. |
| 1f80 | 6d 75 73 74 20 62 65 20 64 6f 63 75 6d 65 6e 74 65 64 20 69 6e 20 74 68 65 20 6e 65 78 74 20 70 | must.be.documented.in.the.next.p |
| 1fa0 | 61 72 74 20 6f 66 20 74 68 65 20 61 72 74 69 63 6c 65 2e 20 55 73 65 20 60 60 3a 3a 6f 70 63 6d | art.of.the.article..Use.``::opcm |
| 1fc0 | 64 2e 2e 60 60 20 66 6f 72 20 74 68 65 73 65 20 63 6f 6d 6d 61 6e 64 73 2e 00 53 6f 6d 65 74 69 | d..``.for.these.commands..Someti |
| 1fe0 | 6d 65 73 20 69 74 20 69 73 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 70 72 6f 76 69 64 65 20 72 | mes.it.is.necessary.to.provide.r |
| 2000 | 65 61 6c 20 49 50 20 61 64 64 72 65 73 73 65 73 20 6c 69 6b 65 20 69 6e 20 74 68 65 20 3a 72 65 | eal.IP.addresses.like.in.the.:re |
| 2020 | 66 3a 60 65 78 61 6d 70 6c 65 73 60 2e 20 46 6f 72 20 74 68 69 73 2c 20 70 6c 65 61 73 65 20 75 | f:`examples`..For.this,.please.u |
| 2040 | 73 65 20 74 68 65 20 73 70 68 69 6e 78 20 63 6f 6d 6d 65 6e 74 20 73 79 6e 74 61 78 20 60 60 2e | se.the.sphinx.comment.syntax.``. |
| 2060 | 2e 20 73 74 6f 70 5f 76 79 6f 73 6c 69 6e 74 65 72 60 60 20 74 6f 20 73 74 6f 70 20 74 68 65 20 | ..stop_vyoslinter``.to.stop.the. |
| 2080 | 6c 69 6e 74 65 72 20 61 6e 64 20 60 60 2e 2e 20 73 74 61 72 74 5f 76 79 6f 73 6c 69 6e 74 65 72 | linter.and.``...start_vyoslinter |
| 20a0 | 60 60 20 74 6f 20 73 74 61 72 74 2e 00 53 74 79 6c 65 20 47 75 69 64 65 00 53 75 62 6d 69 74 20 | ``.to.start..Style.Guide.Submit. |
| 20c0 | 70 75 6c 6c 2d 72 65 71 75 65 73 74 2e 20 49 6e 20 47 69 74 48 75 62 20 76 69 73 69 74 20 74 68 | pull-request..In.GitHub.visit.th |
| 20e0 | 65 20 6d 61 69 6e 20 72 65 70 6f 73 69 74 6f 72 79 20 61 6e 64 20 79 6f 75 20 73 68 6f 75 6c 64 | e.main.repository.and.you.should |
| 2100 | 20 73 65 65 20 61 20 62 61 6e 6e 65 72 20 73 75 67 67 65 73 74 69 6e 67 20 74 6f 20 6d 61 6b 65 | .see.a.banner.suggesting.to.make |
| 2120 | 20 61 20 70 75 6c 6c 20 72 65 71 75 65 73 74 2e 20 46 69 6c 6c 20 6f 75 74 20 74 68 65 20 66 6f | .a.pull.request..Fill.out.the.fo |
| 2140 | 72 6d 20 61 6e 64 20 64 65 73 63 72 69 62 65 20 77 68 61 74 20 79 6f 75 20 64 6f 2e 00 54 4f 43 | rm.and.describe.what.you.do..TOC |
| 2160 | 20 4c 65 76 65 6c 00 54 61 6b 65 20 61 20 6c 6f 6f 6b 20 61 74 20 74 68 65 20 3a 64 6f 63 3a 60 | .Level.Take.a.look.at.the.:doc:` |
| 2180 | 2f 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 60 20 70 61 67 65 20 66 6f 72 20 61 6e 20 69 6e 74 72 | /documentation`.page.for.an.intr |
| 21a0 | 69 63 61 74 65 20 65 78 70 6c 61 6e 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 64 6f 63 75 6d 65 6e | icate.explanation.of.the.documen |
| 21c0 | 74 61 74 69 6f 6e 20 70 72 6f 63 65 73 73 2e 00 54 68 65 20 46 6f 72 6b 69 6e 67 20 57 6f 72 6b | tation.process..The.Forking.Work |
| 21e0 | 66 6c 6f 77 20 69 73 20 66 75 6e 64 61 6d 65 6e 74 61 6c 6c 79 20 64 69 66 66 65 72 65 6e 74 20 | flow.is.fundamentally.different. |
| 2200 | 66 72 6f 6d 20 6f 74 68 65 72 20 70 6f 70 75 6c 61 72 20 47 69 74 20 77 6f 72 6b 66 6c 6f 77 73 | from.other.popular.Git.workflows |
| 2220 | 2e 20 49 6e 73 74 65 61 64 20 6f 66 20 75 73 69 6e 67 20 61 20 73 69 6e 67 6c 65 20 73 65 72 76 | ..Instead.of.using.a.single.serv |
| 2240 | 65 72 2d 73 69 64 65 20 72 65 70 6f 73 69 74 6f 72 79 20 74 6f 20 61 63 74 20 61 73 20 74 68 65 | er-side.repository.to.act.as.the |
| 2260 | 20 22 63 65 6e 74 72 61 6c 22 20 63 6f 64 65 62 61 73 65 2c 20 69 74 20 67 69 76 65 73 20 65 76 | ."central".codebase,.it.gives.ev |
| 2280 | 65 72 79 20 64 65 76 65 6c 6f 70 65 72 20 74 68 65 69 72 20 6f 77 6e 20 73 65 72 76 65 72 2d 73 | ery.developer.their.own.server-s |
| 22a0 | 69 64 65 20 72 65 70 6f 73 69 74 6f 72 79 2e 20 54 68 69 73 20 6d 65 61 6e 73 20 74 68 61 74 20 | ide.repository..This.means.that. |
| 22c0 | 65 61 63 68 20 63 6f 6e 74 72 69 62 75 74 6f 72 20 68 61 73 20 6e 6f 74 20 6f 6e 65 2c 20 62 75 | each.contributor.has.not.one,.bu |
| 22e0 | 74 20 74 77 6f 20 47 69 74 20 72 65 70 6f 73 69 74 6f 72 69 65 73 3a 20 61 20 70 72 69 76 61 74 | t.two.Git.repositories:.a.privat |
| 2300 | 65 20 6c 6f 63 61 6c 20 6f 6e 65 20 61 6e 64 20 61 20 70 75 62 6c 69 63 20 73 65 72 76 65 72 2d | e.local.one.and.a.public.server- |
| 2320 | 73 69 64 65 20 6f 6e 65 2e 00 54 68 65 20 61 72 74 69 63 6c 65 20 73 74 61 72 74 73 20 77 69 74 | side.one..The.article.starts.wit |
| 2340 | 68 20 61 20 73 68 6f 72 74 20 69 6e 74 72 6f 64 75 63 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 | h.a.short.introduction.about.the |
| 2360 | 20 63 6f 6d 6d 61 6e 64 20 6f 72 20 74 68 65 20 74 65 63 68 6e 6f 6c 6f 67 79 2e 20 50 6c 65 61 | .command.or.the.technology..Plea |
| 2380 | 73 65 20 69 6e 63 6c 75 64 65 20 73 6f 6d 65 20 68 65 6c 70 66 75 6c 20 6c 69 6e 6b 73 20 6f 72 | se.include.some.helpful.links.or |
| 23a0 | 20 62 61 63 6b 67 72 6f 75 6e 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 00 54 68 65 20 63 6f 6e | .background.information..The.con |
| 23c0 | 66 69 67 75 72 61 74 69 6f 6e 20 6d 6f 64 65 20 66 6f 6c 64 65 72 20 61 6e 64 20 74 68 65 20 61 | figuration.mode.folder.and.the.a |
| 23e0 | 72 74 69 63 6c 65 73 20 63 6f 76 65 72 20 74 68 65 20 73 70 65 63 69 66 69 63 20 6c 65 76 65 6c | rticles.cover.the.specific.level |
| 2400 | 20 6f 66 20 74 68 65 20 63 6f 6d 6d 61 6e 64 73 2e 20 54 68 65 20 65 78 61 63 74 20 6c 65 76 65 | .of.the.commands..The.exact.leve |
| 2420 | 6c 20 64 65 70 65 6e 64 73 20 6f 6e 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2e 20 54 68 69 73 20 73 | l.depends.on.the.command..This.s |
| 2440 | 68 6f 75 6c 64 20 70 72 6f 76 69 64 65 20 73 74 61 62 69 6c 69 74 79 20 66 6f 72 20 55 52 4c 73 | hould.provide.stability.for.URLs |
| 2460 | 20 75 73 65 64 20 69 6e 20 74 68 65 20 66 6f 72 75 6d 20 6f 72 20 62 6c 6f 67 70 6f 73 74 2e 00 | .used.in.the.forum.or.blogpost.. |
| 2480 | 54 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 68 61 73 20 33 20 64 69 66 66 65 72 65 6e | The.documentation.has.3.differen |
| 24a0 | 74 20 74 79 70 65 73 20 6f 66 20 70 61 67 65 73 2e 20 54 68 65 20 73 61 6d 65 20 6b 69 6e 64 20 | t.types.of.pages..The.same.kind. |
| 24c0 | 6f 66 20 70 61 67 65 73 20 6d 75 73 74 20 68 61 76 65 20 74 68 65 20 73 61 6d 65 20 73 74 72 75 | of.pages.must.have.the.same.stru |
| 24e0 | 63 74 75 72 65 20 74 6f 20 61 63 68 69 65 76 65 20 61 20 72 65 63 6f 67 6e 69 74 69 6f 6e 20 66 | cture.to.achieve.a.recognition.f |
| 2500 | 61 63 74 6f 72 2e 00 54 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 73 6f 75 72 63 65 20 | actor..The.documentation.source. |
| 2520 | 69 73 20 6b 65 70 74 20 69 6e 20 74 68 65 20 47 69 74 20 72 65 70 6f 73 69 74 6f 72 79 20 61 74 | is.kept.in.the.Git.repository.at |
| 2540 | 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 76 79 6f 73 2f 76 79 6f 73 2d 64 6f | .https://github.com/vyos/vyos-do |
| 2560 | 63 75 6d 65 6e 74 61 74 69 6f 6e 20 61 6e 64 20 79 6f 75 20 63 61 6e 20 66 6f 6c 6c 6f 77 20 74 | cumentation.and.you.can.follow.t |
| 2580 | 68 65 20 69 6e 73 74 72 75 63 74 69 6f 6e 73 20 69 6e 20 74 68 65 20 52 45 41 44 4d 45 2e 6d 64 | he.instructions.in.the.README.md |
| 25a0 | 5f 20 74 6f 20 62 75 69 6c 64 20 61 6e 64 20 74 65 73 74 20 79 6f 75 72 20 63 68 61 6e 67 65 73 | _.to.build.and.test.your.changes |
| 25c0 | 2e 00 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 73 20 61 20 71 75 69 63 6b 20 73 75 6d 6d 61 | ..The.following.is.a.quick.summa |
| 25e0 | 72 79 20 6f 66 20 74 68 65 20 72 75 6c 65 73 3a 00 54 68 65 20 6d 61 69 6e 20 61 64 76 61 6e 74 | ry.of.the.rules:.The.main.advant |
| 2600 | 61 67 65 20 6f 66 20 74 68 65 20 46 6f 72 6b 69 6e 67 20 57 6f 72 6b 66 6c 6f 77 20 69 73 20 74 | age.of.the.Forking.Workflow.is.t |
| 2620 | 68 61 74 20 63 6f 6e 74 72 69 62 75 74 69 6f 6e 73 20 63 61 6e 20 62 65 20 69 6e 74 65 67 72 61 | hat.contributions.can.be.integra |
| 2640 | 74 65 64 20 77 69 74 68 6f 75 74 20 74 68 65 20 6e 65 65 64 20 66 6f 72 20 65 76 65 72 79 62 6f | ted.without.the.need.for.everybo |
| 2660 | 64 79 20 74 6f 20 70 75 73 68 20 74 6f 20 61 20 73 69 6e 67 6c 65 20 63 65 6e 74 72 61 6c 20 72 | dy.to.push.to.a.single.central.r |
| 2680 | 65 70 6f 73 69 74 6f 72 79 2e 20 44 65 76 65 6c 6f 70 65 72 73 20 70 75 73 68 20 74 6f 20 74 68 | epository..Developers.push.to.th |
| 26a0 | 65 69 72 20 6f 77 6e 20 73 65 72 76 65 72 2d 73 69 64 65 20 72 65 70 6f 73 69 74 6f 72 69 65 73 | eir.own.server-side.repositories |
| 26c0 | 2c 20 61 6e 64 20 6f 6e 6c 79 20 74 68 65 20 70 72 6f 6a 65 63 74 20 6d 61 69 6e 74 61 69 6e 65 | ,.and.only.the.project.maintaine |
| 26e0 | 72 20 63 61 6e 20 70 75 73 68 20 74 6f 20 74 68 65 20 6f 66 66 69 63 69 61 6c 20 72 65 70 6f 73 | r.can.push.to.the.official.repos |
| 2700 | 69 74 6f 72 79 2e 20 54 68 69 73 20 61 6c 6c 6f 77 73 20 74 68 65 20 6d 61 69 6e 74 61 69 6e 65 | itory..This.allows.the.maintaine |
| 2720 | 72 20 74 6f 20 61 63 63 65 70 74 20 63 6f 6d 6d 69 74 73 20 66 72 6f 6d 20 61 6e 79 20 64 65 76 | r.to.accept.commits.from.any.dev |
| 2740 | 65 6c 6f 70 65 72 20 77 69 74 68 6f 75 74 20 67 69 76 69 6e 67 20 74 68 65 6d 20 77 72 69 74 65 | eloper.without.giving.them.write |
| 2760 | 20 61 63 63 65 73 73 20 74 6f 20 74 68 65 20 6f 66 66 69 63 69 61 6c 20 63 6f 64 65 62 61 73 65 | .access.to.the.official.codebase |
| 2780 | 2e 00 54 68 65 20 70 6c 75 67 69 6e 20 77 69 6c 6c 20 77 61 72 6e 20 6f 6e 20 62 75 69 6c 64 20 | ..The.plugin.will.warn.on.build. |
| 27a0 | 69 66 20 61 20 68 65 61 64 6c 69 6e 65 20 68 61 73 20 61 20 64 75 70 6c 69 63 61 74 65 20 6e 61 | if.a.headline.has.a.duplicate.na |
| 27c0 | 6d 65 20 69 6e 20 74 68 65 20 73 61 6d 65 20 64 6f 63 75 6d 65 6e 74 2e 20 54 6f 20 70 72 65 76 | me.in.the.same.document..To.prev |
| 27e0 | 65 6e 74 20 74 68 69 73 20 77 61 72 6e 69 6e 67 2c 20 79 6f 75 20 68 61 76 65 20 74 6f 20 70 75 | ent.this.warning,.you.have.to.pu |
| 2800 | 74 20 61 20 63 75 73 74 6f 6d 20 6c 69 6e 6b 20 6f 6e 20 74 6f 70 20 6f 66 20 74 68 65 20 68 65 | t.a.custom.link.on.top.of.the.he |
| 2820 | 61 64 6c 69 6e 65 2e 00 54 68 65 6f 72 65 74 69 63 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 | adline..Theoretical.information. |
| 2840 | 72 65 71 75 69 72 65 64 20 66 6f 72 20 75 73 65 72 73 20 74 6f 20 75 6e 64 65 72 73 74 61 6e 64 | required.for.users.to.understand |
| 2860 | 20 74 68 65 20 6e 65 78 74 20 64 6f 63 75 6d 65 6e 74 20 73 65 63 74 69 6f 6e 73 3a 00 54 68 65 | .the.next.document.sections:.The |
| 2880 | 72 65 20 61 72 65 20 61 20 66 65 77 20 74 68 69 6e 67 73 20 74 6f 20 6b 65 65 70 20 69 6e 20 6d | re.are.a.few.things.to.keep.in.m |
| 28a0 | 69 6e 64 20 77 68 65 6e 20 63 6f 6e 74 72 69 62 75 74 69 6e 67 20 74 6f 20 74 68 65 20 64 6f 63 | ind.when.contributing.to.the.doc |
| 28c0 | 75 6d 65 6e 74 61 74 69 6f 6e 2c 20 66 6f 72 20 74 68 65 20 73 61 6b 65 20 6f 66 20 63 6f 6e 73 | umentation,.for.the.sake.of.cons |
| 28e0 | 69 73 74 65 6e 63 79 20 61 6e 64 20 72 65 61 64 61 62 69 6c 69 74 79 2e 00 54 68 69 73 20 73 65 | istency.and.readability..This.se |
| 2900 | 63 74 69 6f 6e 20 6d 75 73 74 20 63 6f 6e 74 61 69 6e 20 61 20 6c 69 73 74 20 6f 66 3a 00 54 6f | ction.must.contain.a.list.of:.To |
| 2920 | 20 65 78 74 72 61 63 74 20 61 20 64 65 66 61 75 6c 74 76 61 6c 75 65 20 66 72 6f 6d 20 74 68 65 | .extract.a.defaultvalue.from.the |
| 2940 | 20 58 4d 4c 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 61 64 64 20 61 20 60 60 3a 64 65 66 61 75 6c | .XML.definitions.add.a.``:defaul |
| 2960 | 74 76 61 6c 75 65 3a 60 60 20 74 6f 20 60 60 2e 2e 20 63 66 67 63 6d 64 3a 3a 60 60 20 64 69 72 | tvalue:``.to.``...cfgcmd::``.dir |
| 2980 | 65 63 74 69 76 65 2e 20 54 6f 20 68 61 76 65 20 74 68 69 73 20 66 65 61 74 75 72 65 20 6c 6f 63 | ective..To.have.this.feature.loc |
| 29a0 | 61 6c 6c 79 2c 20 74 68 65 20 76 79 6f 73 2d 31 78 20 73 75 62 6d 6f 64 75 6c 65 20 6d 75 73 74 | ally,.the.vyos-1x.submodule.must |
| 29c0 | 20 62 65 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 62 65 66 6f 72 65 2e 20 50 6c 65 61 73 65 20 62 | .be.initialized.before..Please.b |
| 29e0 | 65 20 61 77 61 72 65 20 74 6f 20 6e 6f 74 20 75 70 64 61 74 65 20 74 68 65 20 73 75 62 6d 6f 64 | e.aware.to.not.update.the.submod |
| 2a00 | 75 6c 65 20 69 6e 20 79 6f 75 72 20 50 52 2e 00 54 6f 20 6d 69 6e 69 6d 69 7a 65 20 72 65 64 75 | ule.in.your.PR..To.minimize.redu |
| 2a20 | 6e 64 61 6e 63 79 2c 20 74 68 65 72 65 20 69 73 20 61 20 73 70 65 63 69 61 6c 20 69 6e 63 6c 75 | ndancy,.there.is.a.special.inclu |
| 2a40 | 64 65 20 64 69 72 65 63 74 69 76 65 2e 20 49 74 20 69 6e 63 6c 75 64 65 73 20 61 20 74 78 74 20 | de.directive..It.includes.a.txt. |
| 2a60 | 66 69 6c 65 20 61 6e 64 20 72 65 70 6c 61 63 65 20 74 68 65 20 60 60 7b 7b 20 76 61 72 30 20 7d | file.and.replace.the.``{{.var0.} |
| 2a80 | 7d 60 60 20 2d 20 60 60 7b 7b 20 76 61 72 39 20 7d 7d 60 60 20 77 69 74 68 20 74 68 65 20 63 6f | }``.-.``{{.var9.}}``.with.the.co |
| 2aa0 | 72 72 65 63 74 20 76 61 6c 75 65 2e 00 54 72 79 20 6e 6f 74 20 74 6f 20 65 78 63 65 65 64 20 38 | rrect.value..Try.not.to.exceed.8 |
| 2ac0 | 30 20 63 68 61 72 61 63 74 65 72 73 20 70 65 72 20 6c 69 6e 65 2c 20 62 75 74 20 64 6f 6e 27 74 | 0.characters.per.line,.but.don't |
| 2ae0 | 20 62 72 65 61 6b 20 55 52 4c 73 20 6f 76 65 72 20 74 68 69 73 2e 00 55 6e 69 63 61 73 74 20 4d | .break.URLs.over.this..Unicast.M |
| 2b00 | 41 43 20 41 64 64 72 65 73 73 65 73 3a 20 60 60 30 30 2d 35 33 2d 30 30 60 60 20 74 6f 20 60 60 | AC.Addresses:.``00-53-00``.to.`` |
| 2b20 | 30 30 2d 35 33 2d 46 46 60 60 00 55 70 64 61 74 65 73 20 74 6f 20 6f 75 72 20 64 6f 63 75 6d 65 | 00-53-FF``.Updates.to.our.docume |
| 2b40 | 6e 74 61 74 69 6f 6e 20 73 68 6f 75 6c 64 20 62 65 20 64 65 6c 69 76 65 72 65 64 20 62 79 20 61 | ntation.should.be.delivered.by.a |
| 2b60 | 20 47 69 74 48 75 62 20 70 75 6c 6c 2d 72 65 71 75 65 73 74 2e 20 54 68 69 73 20 72 65 71 75 69 | .GitHub.pull-request..This.requi |
| 2b80 | 72 65 73 20 79 6f 75 20 61 6c 72 65 61 64 79 20 68 61 76 65 20 61 20 47 69 74 48 75 62 20 61 63 | res.you.already.have.a.GitHub.ac |
| 2ba0 | 63 6f 75 6e 74 2e 00 55 73 65 20 41 6d 65 72 69 63 61 6e 20 45 6e 67 6c 69 73 68 20 61 74 20 61 | count..Use.American.English.at.a |
| 2bc0 | 6c 6c 20 74 69 6d 65 73 2e 20 49 74 27 73 20 61 6c 77 61 79 73 20 61 20 67 6f 6f 64 20 69 64 65 | ll.times..It's.always.a.good.ide |
| 2be0 | 61 20 74 6f 20 72 75 6e 20 79 6f 75 72 20 74 65 78 74 20 74 68 72 6f 75 67 68 20 61 20 67 72 61 | a.to.run.your.text.through.a.gra |
| 2c00 | 6d 6d 61 72 20 61 6e 64 20 73 70 65 6c 6c 20 63 68 65 63 6b 65 72 2c 20 73 75 63 68 20 61 73 20 | mmar.and.spell.checker,.such.as. |
| 2c20 | 60 47 72 61 6d 6d 61 72 6c 79 60 5f 2e 00 55 73 65 20 6c 69 74 65 72 61 6c 20 62 6c 6f 63 6b 73 | `Grammarly`_..Use.literal.blocks |
| 2c40 | 20 66 6f 72 20 6c 6f 6e 67 65 72 20 73 6e 69 70 70 65 74 73 2e 00 56 69 65 77 20 6d 6f 64 69 66 | .for.longer.snippets..View.modif |
| 2c60 | 69 65 64 20 66 69 6c 65 73 20 62 79 20 63 61 6c 6c 69 6e 67 20 60 60 24 20 67 69 74 20 73 74 61 | ied.files.by.calling.``$.git.sta |
| 2c80 | 74 75 73 60 60 2e 20 59 6f 75 20 77 69 6c 6c 20 67 65 74 20 61 6e 20 6f 76 65 72 76 69 65 77 20 | tus``..You.will.get.an.overview. |
| 2ca0 | 6f 66 20 61 6c 6c 20 66 69 6c 65 73 20 6d 6f 64 69 66 69 65 64 20 62 79 20 79 6f 75 2e 20 59 6f | of.all.files.modified.by.you..Yo |
| 2cc0 | 75 20 63 61 6e 20 61 64 64 20 69 6e 64 69 76 69 64 75 61 6c 20 66 69 6c 65 73 20 74 6f 20 74 68 | u.can.add.individual.files.to.th |
| 2ce0 | 65 20 47 69 74 20 49 6e 64 65 78 20 69 6e 20 74 68 65 20 6e 65 78 74 20 73 74 65 70 2e 00 56 79 | e.Git.Index.in.the.next.step..Vy |
| 2d00 | 4f 53 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 69 73 20 77 72 69 74 74 65 6e 20 69 6e 20 72 | OS.documentation.is.written.in.r |
| 2d20 | 65 53 74 72 75 63 74 75 72 65 64 54 65 78 74 20 61 6e 64 20 67 65 6e 65 72 61 74 65 64 20 74 6f | eStructuredText.and.generated.to |
| 2d40 | 20 52 65 61 64 20 74 68 65 20 44 6f 63 73 20 70 61 67 65 73 20 77 69 74 68 20 53 70 68 69 6e 78 | .Read.the.Docs.pages.with.Sphinx |
| 2d60 | 2c 20 61 73 20 70 65 72 20 74 68 65 20 50 79 74 68 6f 6e 20 74 72 61 64 69 74 69 6f 6e 2c 20 61 | ,.as.per.the.Python.tradition,.a |
| 2d80 | 73 20 77 65 6c 6c 20 61 73 20 50 44 46 20 66 69 6c 65 73 20 66 6f 72 20 6f 66 66 6c 69 6e 65 20 | s.well.as.PDF.files.for.offline. |
| 2da0 | 75 73 65 20 74 68 72 6f 75 67 68 20 4c 61 54 65 58 2e 20 57 65 20 77 65 6c 63 6f 6d 65 20 61 6c | use.through.LaTeX..We.welcome.al |
| 2dc0 | 6c 20 73 6f 72 74 73 20 6f 66 20 63 6f 6e 74 72 69 62 75 74 69 6f 6e 73 20 74 6f 20 74 68 65 20 | l.sorts.of.contributions.to.the. |
| 2de0 | 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2e 20 4e 6f 74 20 6a 75 73 74 20 6e 65 77 20 61 64 64 69 | documentation..Not.just.new.addi |
| 2e00 | 74 69 6f 6e 73 20 62 75 74 20 61 6c 73 6f 20 63 6f 72 72 65 63 74 69 6f 6e 73 20 74 6f 20 65 78 | tions.but.also.corrections.to.ex |
| 2e20 | 69 73 74 69 6e 67 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2e 00 56 79 4f 53 20 64 6f 63 75 6d | isting.documentation..VyOS.docum |
| 2e40 | 65 6e 74 61 74 69 6f 6e 20 69 73 20 77 72 69 74 74 65 6e 20 69 6e 20 72 65 53 74 72 75 63 74 75 | entation.is.written.in.reStructu |
| 2e60 | 72 65 64 54 65 78 74 20 61 6e 64 20 67 65 6e 65 72 61 74 65 64 20 74 6f 20 52 65 61 64 20 74 68 | redText.and.generated.to.Read.th |
| 2e80 | 65 20 44 6f 63 73 20 70 61 67 65 73 20 77 69 74 68 20 53 70 68 69 6e 78 2c 20 61 73 20 70 65 72 | e.Docs.pages.with.Sphinx,.as.per |
| 2ea0 | 20 74 68 65 20 50 79 74 68 6f 6e 20 74 72 61 64 69 74 69 6f 6e 2e 20 57 65 20 77 65 6c 63 6f 6d | .the.Python.tradition..We.welcom |
| 2ec0 | 65 20 61 6c 6c 20 73 6f 72 74 73 20 6f 66 20 63 6f 6e 74 72 69 62 75 74 69 6f 6e 73 20 74 6f 20 | e.all.sorts.of.contributions.to. |
| 2ee0 | 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2e 20 4e 6f 74 20 6a 75 73 74 20 6e 65 77 20 | the.documentation..Not.just.new. |
| 2f00 | 61 64 64 69 74 69 6f 6e 73 20 62 75 74 20 61 6c 73 6f 20 63 6f 72 72 65 63 74 69 6f 6e 73 20 74 | additions.but.also.corrections.t |
| 2f20 | 6f 20 65 78 69 73 74 69 6e 67 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2e 00 57 65 20 65 6e 63 | o.existing.documentation..We.enc |
| 2f40 | 6f 75 72 61 67 65 20 65 76 65 72 79 20 56 79 4f 53 20 75 73 65 72 20 74 6f 20 68 65 6c 70 20 75 | ourage.every.VyOS.user.to.help.u |
| 2f60 | 73 20 69 6d 70 72 6f 76 65 20 6f 75 72 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 61 73 20 77 | s.improve.our.documentation.as.w |
| 2f80 | 65 20 68 61 76 65 20 61 20 64 65 66 69 63 69 74 20 6c 69 6b 65 20 6d 6f 73 74 20 73 6f 66 74 77 | e.have.a.deficit.like.most.softw |
| 2fa0 | 61 72 65 20 70 72 6f 6a 65 63 74 73 2e 20 20 54 68 69 73 20 6e 6f 74 20 6f 6e 6c 79 20 68 65 6c | are.projects...This.not.only.hel |
| 2fc0 | 70 73 20 79 6f 75 20 77 68 65 6e 20 72 65 61 64 69 6e 67 20 62 75 74 20 61 6c 73 6f 20 65 76 65 | ps.you.when.reading.but.also.eve |
| 2fe0 | 72 79 6f 6e 65 20 65 6c 73 65 2e 00 57 65 20 75 73 65 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 | ryone.else..We.use.the.following |
| 3000 | 20 73 79 6e 74 61 78 20 66 6f 72 20 48 65 61 64 6c 69 6e 65 73 2e 00 57 68 65 6e 20 64 6f 63 75 | .syntax.for.Headlines..When.docu |
| 3020 | 6d 65 6e 74 69 6e 67 20 43 4c 49 20 63 6f 6d 6d 61 6e 64 73 2c 20 75 73 65 20 74 68 65 20 60 60 | menting.CLI.commands,.use.the.`` |
| 3040 | 2e 2e 20 63 66 67 63 6d 64 3a 3a 60 60 20 64 69 72 65 63 74 69 76 65 20 66 6f 72 20 61 6c 6c 20 | ...cfgcmd::``.directive.for.all. |
| 3060 | 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6d 6f 64 65 20 63 6f 6d 6d 61 6e 64 73 2e 20 41 6e 20 | configuration.mode.commands..An. |
| 3080 | 65 78 70 6c 61 6e 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 64 65 73 63 72 69 62 65 64 20 63 6f 6d | explanation.of.the.described.com |
| 30a0 | 6d 61 6e 64 20 73 68 6f 75 6c 64 20 62 65 20 61 64 64 65 64 20 62 65 6c 6f 77 20 74 68 69 73 20 | mand.should.be.added.below.this. |
| 30c0 | 73 74 61 74 65 6d 65 6e 74 2e 20 52 65 70 6c 61 63 65 20 61 6c 6c 20 76 61 72 69 61 62 6c 65 20 | statement..Replace.all.variable. |
| 30e0 | 63 6f 6e 74 65 6e 74 73 20 77 69 74 68 20 3c 76 61 6c 75 65 3e 20 6f 72 20 73 6f 6d 65 74 68 69 | contents.with.<value>.or.somethi |
| 3100 | 6e 67 20 73 69 6d 69 6c 61 72 2e 00 57 68 65 6e 20 64 6f 63 75 6d 65 6e 74 69 6e 67 20 6f 70 65 | ng.similar..When.documenting.ope |
| 3120 | 72 61 74 69 6f 6e 61 6c 20 6c 65 76 65 6c 20 63 6f 6d 6d 61 6e 64 73 2c 20 75 73 65 20 74 68 65 | rational.level.commands,.use.the |
| 3140 | 20 60 60 2e 2e 20 6f 70 63 6d 64 3a 3a 60 60 20 64 69 72 65 63 74 69 76 65 2e 20 41 6e 20 65 78 | .``...opcmd::``.directive..An.ex |
| 3160 | 70 6c 61 6e 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 64 65 73 63 72 69 62 65 64 20 63 6f 6d 6d 61 | planation.of.the.described.comma |
| 3180 | 6e 64 20 73 68 6f 75 6c 64 20 62 65 20 61 64 64 65 64 20 62 65 6c 6f 77 20 74 68 69 73 20 73 74 | nd.should.be.added.below.this.st |
| 31a0 | 61 74 65 6d 65 6e 74 2e 00 57 68 65 6e 20 69 6e 20 64 6f 75 62 74 2c 20 66 6f 6c 6c 6f 77 20 74 | atement..When.in.doubt,.follow.t |
| 31c0 | 68 65 20 73 74 79 6c 65 20 6f 66 20 65 78 69 73 74 69 6e 67 20 64 6f 63 75 6d 65 6e 74 61 74 69 | he.style.of.existing.documentati |
| 31e0 | 6f 6e 2e 00 57 68 65 6e 20 72 65 66 65 72 65 6e 63 69 6e 67 20 74 6f 20 56 79 4f 53 20 50 68 61 | on..When.referencing.to.VyOS.Pha |
| 3200 | 62 72 69 63 61 74 6f 72 20 54 61 73 6b 73 2c 20 74 68 65 72 65 20 69 73 20 61 20 63 75 73 74 6f | bricator.Tasks,.there.is.a.custo |
| 3220 | 6d 20 53 70 68 69 6e 78 20 4d 61 72 6b 75 70 20 63 6f 6d 6d 61 6e 64 20 63 61 6c 6c 65 64 20 60 | m.Sphinx.Markup.command.called.` |
| 3240 | 60 76 79 74 61 73 6b 60 60 20 74 68 61 74 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 72 65 6e | `vytask``.that.automatically.ren |
| 3260 | 64 65 72 73 20 74 6f 20 61 20 70 72 6f 70 65 72 20 50 68 61 62 72 69 63 61 74 6f 72 20 55 52 4c | ders.to.a.proper.Phabricator.URL |
| 3280 | 2e 20 54 68 69 73 20 69 73 20 68 65 61 76 69 6c 79 20 75 73 65 64 20 69 6e 20 74 68 65 20 3a 72 | ..This.is.heavily.used.in.the.:r |
| 32a0 | 65 66 3a 60 72 65 6c 65 61 73 65 2d 6e 6f 74 65 73 60 20 73 65 63 74 69 6f 6e 2e 00 57 69 74 68 | ef:`release-notes`.section..With |
| 32c0 | 20 74 68 6f 73 65 20 63 75 73 74 6f 6d 20 63 6f 6d 6d 61 6e 64 73 2c 20 69 74 20 69 73 20 70 6f | .those.custom.commands,.it.is.po |
| 32e0 | 73 73 69 62 6c 65 20 74 6f 20 72 65 6e 64 65 72 20 74 68 65 6d 20 69 6e 20 61 20 6d 6f 72 65 20 | ssible.to.render.them.in.a.more. |
| 3300 | 64 65 73 63 72 69 70 74 69 76 65 20 77 61 79 20 69 6e 20 74 68 65 20 72 65 73 75 6c 74 69 6e 67 | descriptive.way.in.the.resulting |
| 3320 | 20 48 54 4d 4c 2f 50 44 46 20 6d 61 6e 75 61 6c 2e 00 57 69 74 68 20 74 68 6f 73 65 20 63 75 73 | .HTML/PDF.manual..With.those.cus |
| 3340 | 74 6f 6d 20 63 6f 6d 6d 61 6e 64 73 2c 20 69 74 20 77 69 6c 6c 20 62 65 20 70 6f 73 73 69 62 6c | tom.commands,.it.will.be.possibl |
| 3360 | 65 20 74 6f 20 72 65 6e 64 65 72 20 74 68 65 6d 20 69 6e 20 61 20 6d 6f 72 65 20 64 65 73 63 72 | e.to.render.them.in.a.more.descr |
| 3380 | 69 70 74 69 76 65 20 77 61 79 20 69 6e 20 74 68 65 20 72 65 73 75 6c 74 69 6e 67 20 48 54 4d 4c | iptive.way.in.the.resulting.HTML |
| 33a0 | 2f 50 44 46 20 6d 61 6e 75 61 6c 2e 00 57 72 69 74 65 20 44 6f 63 75 6d 65 6e 74 61 74 69 6f 6e | /PDF.manual..Write.Documentation |
| 33c0 | 00 59 6f 75 20 63 61 6e 20 65 69 74 68 65 72 20 69 6e 73 74 61 6c 6c 20 53 70 68 69 6e 78 20 28 | .You.can.either.install.Sphinx.( |
| 33e0 | 61 6e 64 20 54 65 58 20 4c 69 76 65 20 66 6f 72 20 50 44 46 20 6f 75 74 70 75 74 29 20 61 6e 64 | and.TeX.Live.for.PDF.output).and |
| 3400 | 20 62 75 69 6c 64 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 6c 6f 63 61 6c 6c 79 | .build.the.documentation.locally |
| 3420 | 2c 20 6f 72 20 75 73 65 20 74 68 65 20 44 6f 63 6b 65 72 66 69 6c 65 5f 20 74 6f 20 62 75 69 6c | ,.or.use.the.Dockerfile_.to.buil |
| 3440 | 64 20 69 74 20 69 6e 20 61 20 63 6f 6e 74 61 69 6e 65 72 2e 00 59 6f 75 20 63 61 6e 20 65 69 74 | d.it.in.a.container..You.can.eit |
| 3460 | 68 65 72 20 69 6e 73 74 61 6c 6c 20 53 70 68 69 6e 78 20 61 6e 64 20 62 75 69 6c 64 20 74 68 65 | her.install.Sphinx.and.build.the |
| 3480 | 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 6c 6f 63 61 6c 6c 79 2c 20 6f 72 20 75 73 65 20 74 | .documentation.locally,.or.use.t |
| 34a0 | 68 65 20 44 6f 63 6b 65 72 66 69 6c 65 5f 20 74 6f 20 62 75 69 6c 64 20 69 74 20 69 6e 20 61 20 | he.Dockerfile_.to.build.it.in.a. |
| 34c0 | 63 6f 6e 74 61 69 6e 65 72 2e 00 59 6f 75 72 20 72 65 6d 6f 74 65 20 72 65 70 6f 20 6f 6e 20 47 | container..Your.remote.repo.on.G |
| 34e0 | 69 74 68 75 62 20 69 73 20 63 61 6c 6c 65 64 20 60 60 6f 72 69 67 69 6e 60 60 2c 20 77 68 69 6c | ithub.is.called.``origin``,.whil |
| 3500 | 65 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 72 65 70 6f 20 79 6f 75 20 68 61 76 65 20 66 6f 72 | e.the.original.repo.you.have.for |
| 3520 | 6b 65 64 20 69 73 20 63 61 6c 6c 65 64 20 60 60 75 70 73 74 72 65 61 6d 60 60 2e 20 4e 6f 77 20 | ked.is.called.``upstream``..Now. |
| 3540 | 79 6f 75 20 63 61 6e 20 6c 6f 63 61 6c 6c 79 20 75 70 64 61 74 65 20 79 6f 75 72 20 66 6f 72 6b | you.can.locally.update.your.fork |
| 3560 | 65 64 20 72 65 70 6f 2e 00 60 60 31 39 32 2e 30 2e 32 2e 30 2f 32 34 60 60 00 60 60 31 39 38 2e | ed.repo..``192.0.2.0/24``.``198. |
| 3580 | 35 31 2e 31 30 30 2e 30 2f 32 34 60 60 00 60 60 32 30 30 31 3a 64 62 38 3a 3a 2f 33 32 60 60 00 | 51.100.0/24``.``2001:db8::/32``. |
| 35a0 | 60 60 32 30 33 2e 30 2e 31 31 33 2e 30 2f 32 34 60 60 00 60 60 3a 72 65 66 3a 60 43 68 65 63 6b | ``203.0.113.0/24``.``:ref:`Check |
| 35c0 | 20 6f 75 74 20 56 4c 41 4e 3c 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2f 69 6e 74 65 72 66 61 63 | .out.VLAN<configuration/interfac |
| 35e0 | 65 73 2f 65 74 68 65 72 6e 65 74 3a 76 6c 61 6e 3e 60 60 00 60 60 3a 72 65 66 3a 60 63 6f 6e 66 | es/ethernet:vlan>``.``:ref:`conf |
| 3600 | 69 67 75 72 61 74 69 6f 6e 2f 69 6e 74 65 72 66 61 63 65 73 2f 65 74 68 65 72 6e 65 74 3a 76 6c | iguration/interfaces/ethernet:vl |
| 3620 | 61 6e 60 60 00 60 60 73 65 74 20 66 69 72 65 77 61 6c 6c 20 7a 6f 6e 65 60 60 20 69 73 20 77 72 | an``.``set.firewall.zone``.is.wr |
| 3640 | 69 74 74 65 6e 20 69 6e 20 60 60 66 69 72 65 77 61 6c 6c 2f 7a 6f 6e 65 2e 72 73 74 60 60 00 60 | itten.in.``firewall/zone.rst``.` |
| 3660 | 60 73 65 74 20 69 6e 74 65 72 66 61 63 65 73 20 65 74 68 65 72 6e 65 74 60 60 20 69 73 20 77 72 | `set.interfaces.ethernet``.is.wr |
| 3680 | 69 74 74 65 6e 20 69 6e 20 60 60 69 6e 74 65 72 66 61 63 65 73 2f 65 74 68 65 72 6e 65 74 2e 72 | itten.in.``interfaces/ethernet.r |
| 36a0 | 73 74 60 60 00 61 20 73 69 6d 70 6c 65 20 65 78 70 6c 61 6e 61 74 69 6f 6e 20 6f 66 20 77 68 61 | st``.a.simple.explanation.of.wha |
| 36c0 | 74 20 69 73 20 74 68 69 73 20 70 61 67 65 20 61 62 6f 75 74 2c 20 77 68 79 20 6f 72 20 77 68 65 | t.is.this.page.about,.why.or.whe |
| 36e0 | 6e 20 69 74 20 69 73 20 72 65 71 75 69 72 65 64 20 74 6f 20 62 65 20 75 73 65 64 00 63 66 67 63 | n.it.is.required.to.be.used.cfgc |
| 3700 | 6d 64 00 63 6d 64 69 6e 63 6c 75 64 65 00 68 61 6e 64 6c 65 20 62 75 69 6c 64 20 65 72 72 6f 72 | md.cmdinclude.handle.build.error |
| 3720 | 73 00 68 6f 77 20 74 6f 20 63 6f 6c 6c 65 63 74 20 6c 6f 67 73 20 6f 72 20 6f 74 68 65 72 20 64 | s.how.to.collect.logs.or.other.d |
| 3740 | 65 62 75 67 67 69 6e 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 28 6c 69 6b 65 20 60 73 68 6f 77 | ebugging.information.(like.`show |
| 3760 | 60 20 63 6f 6d 6d 61 6e 64 73 20 6f 75 74 70 75 74 29 00 68 6f 77 20 74 6f 20 72 65 61 64 20 61 | `.commands.output).how.to.read.a |
| 3780 | 6e 64 20 77 68 61 74 20 74 6f 20 73 65 61 72 63 68 20 66 6f 72 20 69 6e 20 6c 6f 67 73 20 61 6e | nd.what.to.search.for.in.logs.an |
| 37a0 | 64 20 63 6f 6c 6c 65 63 74 65 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 00 6b 6e 6f 77 6e 20 69 73 | d.collected.information.known.is |
| 37c0 | 73 75 65 73 20 6f 72 20 70 6f 74 65 6e 74 69 61 6c 20 70 72 6f 62 6c 65 6d 73 20 66 6f 72 20 74 | sues.or.potential.problems.for.t |
| 37e0 | 68 65 20 73 65 72 76 69 63 65 20 6f 72 20 75 73 65 20 63 61 73 65 00 6f 70 63 6d 64 00 72 65 66 | he.service.or.use.case.opcmd.ref |
| 3800 | 65 72 65 6e 63 65 73 20 74 6f 20 73 74 61 6e 64 61 72 64 73 2c 20 52 46 43 73 00 74 68 65 20 63 | erences.to.standards,.RFCs.the.c |
| 3820 | 6f 6e 74 65 6e 74 20 6f 66 20 69 6e 74 65 72 66 61 63 65 2d 61 64 64 72 65 73 73 2e 74 78 74 20 | ontent.of.interface-address.txt. |
| 3840 | 6c 6f 6f 6b 73 20 6c 69 6b 65 20 74 68 69 73 00 74 6f 20 75 73 65 20 61 6e 20 61 6c 74 65 72 6e | looks.like.this.to.use.an.altern |
| 3860 | 61 74 69 76 65 20 68 79 70 65 72 6c 69 6e 6b 20 75 73 65 20 69 74 20 74 68 69 73 20 77 61 79 3a | ative.hyperlink.use.it.this.way: |
| 3880 | 00 76 79 74 61 73 6b 00 77 68 61 74 20 61 72 65 20 69 6e 64 69 63 61 74 6f 72 73 20 6f 66 20 67 | .vytask.what.are.indicators.of.g |
| 38a0 | 6f 6f 64 20 61 6e 64 20 62 61 64 20 73 74 61 74 65 73 20 69 6e 20 64 65 62 75 67 67 69 6e 67 20 | ood.and.bad.states.in.debugging. |
| 38c0 | 6f 75 74 70 75 74 73 00 77 6f 72 6b 61 72 6f 75 6e 64 73 20 66 6f 72 20 6b 6e 6f 77 6e 20 69 73 | outputs.workarounds.for.known.is |
| 38e0 | 73 75 65 73 20 28 69 66 20 61 6e 79 20 65 78 69 73 74 29 00 4d 49 4d 45 2d 56 65 72 73 69 6f 6e | sues.(if.any.exist).MIME-Version |
| 3900 | 3a 20 31 2e 30 0a 43 6f 6e 74 65 6e 74 2d 54 79 70 65 3a 20 74 65 78 74 2f 70 6c 61 69 6e 3b 20 | :.1.0.Content-Type:.text/plain;. |
| 3920 | 63 68 61 72 73 65 74 3d 55 54 46 2d 38 0a 43 6f 6e 74 65 6e 74 2d 54 72 61 6e 73 66 65 72 2d 45 | charset=UTF-8.Content-Transfer-E |
| 3940 | 6e 63 6f 64 69 6e 67 3a 20 38 62 69 74 0a 58 2d 47 65 6e 65 72 61 74 6f 72 3a 20 4c 6f 63 61 6c | ncoding:.8bit.X-Generator:.Local |
| 3960 | 61 7a 79 20 28 68 74 74 70 73 3a 2f 2f 6c 6f 63 61 6c 61 7a 79 2e 63 6f 6d 29 0a 50 72 6f 6a 65 | azy.(https://localazy.com).Proje |
| 3980 | 63 74 2d 49 64 2d 56 65 72 73 69 6f 6e 3a 20 0a 4c 61 6e 67 75 61 67 65 3a 20 75 6b 0a 50 6c 75 | ct-Id-Version:..Language:.uk.Plu |
| 39a0 | 72 61 6c 2d 46 6f 72 6d 73 3a 20 6e 70 6c 75 72 61 6c 73 3d 33 3b 20 70 6c 75 72 61 6c 3d 28 28 | ral-Forms:.nplurals=3;.plural=(( |
| 39c0 | 6e 25 31 30 3d 3d 31 29 20 26 26 20 28 6e 25 31 30 30 21 3d 31 31 29 29 20 3f 20 30 20 3a 20 28 | n%10==1).&&.(n%100!=11)).?.0.:.( |
| 39e0 | 28 6e 25 31 30 3e 3d 32 20 26 26 20 6e 25 31 30 3c 3d 34 29 20 26 26 20 28 28 6e 25 31 30 30 3c | (n%10>=2.&&.n%10<=4).&&.((n%100< |
| 3a00 | 31 32 20 7c 7c 20 6e 25 31 30 30 3e 31 34 29 29 29 20 3f 20 31 20 3a 20 32 3b 0a 00 31 2e 20 54 | 12.||.n%100>14))).?.1.:.2;..1..T |
| 3a20 | 68 65 6f 72 65 74 69 63 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 00 31 36 62 69 74 20 41 53 4e | heoretical.information.16bit.ASN |
| 3a40 | 3a 20 60 60 36 34 34 39 36 20 2d 20 36 34 35 31 31 60 60 00 32 2e 20 43 6f 6e 66 69 67 75 72 61 | :.``64496.-.64511``.2..Configura |
| 3a60 | 74 69 6f 6e 20 64 65 73 63 72 69 70 74 69 6f 6e 00 33 2e 20 43 6f 6e 66 69 67 75 72 61 74 69 6f | tion.description.3..Configuratio |
| 3a80 | 6e 20 65 78 61 6d 70 6c 65 73 00 33 32 62 69 74 20 41 53 4e 3a 20 60 60 36 35 35 33 36 20 2d 20 | n.examples.32bit.ASN:.``65536.-. |
| 3aa0 | 36 35 35 35 31 60 60 00 34 2e 20 4b 6e 6f 77 6e 20 69 73 73 75 65 73 00 35 2e 20 44 65 62 75 67 | 65551``.4..Known.issues.5..Debug |
| 3ac0 | 67 69 6e 67 00 41 20 70 6c 75 67 69 6e 20 77 69 6c 6c 20 62 65 20 75 73 65 64 20 74 6f 20 67 65 | ging.A.plugin.will.be.used.to.ge |
| 3ae0 | 6e 65 72 61 74 65 20 61 20 72 65 66 65 72 65 6e 63 65 20 6c 61 62 65 6c 20 66 6f 72 20 65 61 63 | nerate.a.reference.label.for.eac |
| 3b00 | 68 20 68 65 61 64 6c 69 6e 65 2e 20 54 6f 20 72 65 66 65 72 65 6e 63 65 20 61 20 70 61 67 65 20 | h.headline..To.reference.a.page. |
| 3b20 | 6f 72 20 61 20 73 65 63 74 69 6f 6e 20 69 6e 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f | or.a.section.in.the.documentatio |
| 3b40 | 6e 20 75 73 65 20 74 68 65 20 60 60 3a 72 65 66 3a 60 60 20 63 6f 6d 6d 61 6e 64 2e 00 41 64 64 | n.use.the.``:ref:``.command..Add |
| 3b60 | 20 6d 6f 64 69 66 69 65 64 20 66 69 6c 65 73 20 74 6f 20 47 69 74 20 69 6e 64 65 78 20 60 60 24 | .modified.files.to.Git.index.``$ |
| 3b80 | 20 67 69 74 20 61 64 64 20 70 61 74 68 2f 74 6f 2f 66 69 6c 65 6e 61 6d 65 60 60 20 6f 72 20 61 | .git.add.path/to/filename``.or.a |
| 3ba0 | 64 64 20 61 6c 6c 20 75 6e 73 74 61 67 65 64 20 66 69 6c 65 73 20 60 60 24 20 67 69 74 20 61 64 | dd.all.unstaged.files.``$.git.ad |
| 3bc0 | 64 20 2e 60 60 2e 20 41 6c 6c 20 66 69 6c 65 73 20 61 64 64 65 64 20 74 6f 20 74 68 65 20 47 69 | d..``..All.files.added.to.the.Gi |
| 3be0 | 74 20 69 6e 64 65 78 20 77 69 6c 6c 20 62 65 20 70 61 72 74 20 6f 66 20 79 6f 75 20 66 6f 6c 6c | t.index.will.be.part.of.you.foll |
| 3c00 | 6f 77 69 6e 67 20 47 69 74 20 63 6f 6d 6d 69 74 2e 00 41 64 64 72 65 73 73 20 73 70 61 63 65 00 | owing.Git.commit..Address.space. |
| 3c20 | 41 6c 6c 20 52 53 54 20 66 69 6c 65 73 20 6d 75 73 74 20 66 6f 6c 6c 6f 77 20 74 68 65 20 73 61 | All.RST.files.must.follow.the.sa |
| 3c40 | 6d 65 20 54 4f 43 20 4c 65 76 65 6c 20 73 79 6e 74 61 78 20 61 6e 64 20 68 61 76 65 20 74 6f 20 | me.TOC.Level.syntax.and.have.to. |
| 3c60 | 73 74 61 72 74 20 77 69 74 68 00 41 6e 20 6f 70 74 69 6f 6e 61 6c 20 73 65 63 74 69 6f 6e 20 66 | start.with.An.optional.section.f |
| 3c80 | 6f 6c 6c 6f 77 73 2e 20 53 6f 6d 65 20 63 6f 6d 6d 61 6e 64 73 20 68 61 76 65 20 72 65 71 75 69 | ollows..Some.commands.have.requi |
| 3ca0 | 72 65 6d 65 6e 74 73 20 6c 69 6b 65 20 63 6f 6d 70 61 74 69 62 6c 65 20 68 61 72 64 77 61 72 65 | rements.like.compatible.hardware |
| 3cc0 | 20 28 65 2e 67 2e 20 57 69 66 69 29 20 6f 72 20 73 6f 6d 65 20 63 6f 6d 6d 61 6e 64 73 20 79 6f | .(e.g..Wifi).or.some.commands.yo |
| 3ce0 | 75 20 68 61 76 65 20 74 6f 20 73 65 74 20 62 65 66 6f 72 65 2e 20 46 6f 72 20 65 78 61 6d 70 6c | u.have.to.set.before..For.exampl |
| 3d00 | 65 2c 20 69 74 20 69 73 20 72 65 63 6f 6d 6d 65 6e 64 65 64 20 74 6f 20 73 65 74 20 61 20 72 6f | e,.it.is.recommended.to.set.a.ro |
| 3d20 | 75 74 65 2d 6d 61 70 20 62 65 66 6f 72 65 20 63 6f 6e 66 69 67 75 72 69 6e 67 20 42 47 50 2e 00 | ute-map.before.configuring.BGP.. |
| 3d40 | 41 6e 64 20 66 69 6e 61 6c 6c 79 2c 20 72 65 6d 65 6d 62 65 72 20 74 68 61 74 20 74 68 65 20 72 | And.finally,.remember.that.the.r |
| 3d60 | 65 53 74 72 75 63 74 75 72 65 64 54 65 78 74 20 66 69 6c 65 73 20 61 72 65 6e 27 74 20 65 78 63 | eStructuredText.files.aren't.exc |
| 3d80 | 6c 75 73 69 76 65 6c 79 20 66 6f 72 20 67 65 6e 65 72 61 74 69 6e 67 20 48 54 4d 4c 20 61 6e 64 | lusively.for.generating.HTML.and |
| 3da0 | 20 50 44 46 2e 20 54 68 65 79 20 73 68 6f 75 6c 64 20 62 65 20 68 75 6d 61 6e 2d 72 65 61 64 61 | .PDF..They.should.be.human-reada |
| 3dc0 | 62 6c 65 20 61 6e 64 20 65 61 73 69 6c 79 20 70 65 72 75 73 65 64 20 66 72 6f 6d 20 61 20 63 6f | ble.and.easily.perused.from.a.co |
| 3de0 | 6e 73 6f 6c 65 2e 00 41 6e 79 74 68 69 6e 67 20 65 6c 73 65 00 41 6e 79 74 68 69 6e 67 20 65 6c | nsole..Anything.else.Anything.el |
| 3e00 | 73 65 20 74 68 61 74 20 69 73 20 6e 6f 74 20 61 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6f | se.that.is.not.a.configuration.o |
| 3e20 | 72 20 61 6e 20 6f 70 65 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 20 68 61 73 20 6e 6f 20 70 72 | r.an.operation.command.has.no.pr |
| 3e40 | 65 64 65 66 69 6e 65 64 20 73 74 72 75 63 74 75 72 65 2e 00 41 75 74 6f 6c 69 6e 74 65 72 00 43 | edefined.structure..Autolinter.C |
| 3e60 | 68 65 63 6b 20 79 6f 75 72 20 63 68 61 6e 67 65 73 20 62 79 20 6c 6f 63 61 6c 6c 79 20 62 75 69 | heck.your.changes.by.locally.bui |
| 3e80 | 6c 64 69 6e 67 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 60 60 24 20 6d 61 6b 65 | lding.the.documentation.``$.make |
| 3ea0 | 20 6c 69 76 65 68 74 6d 6c 60 60 2e 20 53 70 68 69 6e 78 20 77 69 6c 6c 20 62 75 69 6c 64 20 74 | .livehtml``..Sphinx.will.build.t |
| 3ec0 | 68 65 20 68 74 6d 6c 20 66 69 6c 65 73 20 69 6e 20 74 68 65 20 60 60 64 6f 63 73 2f 5f 62 75 69 | he.html.files.in.the.``docs/_bui |
| 3ee0 | 6c 64 60 60 20 66 6f 6c 64 65 72 2e 20 57 65 20 70 72 6f 76 69 64 65 20 79 6f 75 20 77 69 74 68 | ld``.folder..We.provide.you.with |
| 3f00 | 20 61 20 44 6f 63 6b 65 72 20 63 6f 6e 74 61 69 6e 65 72 20 66 6f 72 20 61 6e 20 65 61 73 79 2d | .a.Docker.container.for.an.easy- |
| 3f20 | 74 6f 2d 75 73 65 20 75 73 65 72 20 65 78 70 65 72 69 65 6e 63 65 2e 20 43 68 65 63 6b 20 74 68 | to-use.user.experience..Check.th |
| 3f40 | 65 20 52 45 41 44 4d 45 2e 6d 64 5f 20 66 69 6c 65 20 6f 66 20 74 68 69 73 20 72 65 70 6f 73 69 | e.README.md_.file.of.this.reposi |
| 3f60 | 74 6f 72 79 2e 00 43 68 65 63 6b 20 79 6f 75 72 20 63 6f 6e 66 69 67 75 72 65 64 20 72 65 6d 6f | tory..Check.your.configured.remo |
| 3f80 | 74 65 20 72 65 70 6f 73 69 74 6f 72 69 65 73 3a 00 43 6c 6f 6e 65 20 66 6f 72 6b 20 74 6f 20 6c | te.repositories:.Clone.fork.to.l |
| 3fa0 | 6f 63 61 6c 20 6d 61 63 68 69 6e 65 2c 20 74 68 65 6e 20 63 68 61 6e 67 65 20 74 6f 20 74 68 61 | ocal.machine,.then.change.to.tha |
| 3fc0 | 74 20 64 69 72 65 63 74 6f 72 79 20 60 60 24 20 63 64 20 76 79 6f 73 2d 64 6f 63 75 6d 65 6e 74 | t.directory.``$.cd.vyos-document |
| 3fe0 | 61 74 69 6f 6e 60 60 00 43 6f 6d 6d 69 74 20 79 6f 75 72 20 63 68 61 6e 67 65 73 20 77 69 74 68 | ation``.Commit.your.changes.with |
| 4000 | 20 74 68 65 20 6d 65 73 73 61 67 65 2c 20 60 60 24 20 67 69 74 20 63 6f 6d 6d 69 74 20 2d 6d 20 | .the.message,.``$.git.commit.-m. |
| 4020 | 22 3c 63 6f 6d 6d 69 74 20 6d 65 73 73 61 67 65 3e 22 60 60 20 6f 72 20 20 75 73 65 20 60 60 24 | "<commit.message>"``.or..use.``$ |
| 4040 | 20 67 69 74 20 63 6f 6d 6d 69 74 20 2d 76 60 60 20 74 6f 20 68 61 76 65 20 79 6f 75 72 20 63 6f | .git.commit.-v``.to.have.your.co |
| 4060 | 6e 66 69 67 75 72 65 64 20 65 64 69 74 6f 72 20 6c 61 75 6e 63 68 65 64 2e 20 59 6f 75 20 63 61 | nfigured.editor.launched..You.ca |
| 4080 | 6e 20 74 79 70 65 20 69 6e 20 61 20 63 6f 6d 6d 69 74 20 6d 65 73 73 61 67 65 2e 20 41 67 61 69 | n.type.in.a.commit.message..Agai |
| 40a0 | 6e 20 70 6c 65 61 73 65 20 6d 61 6b 65 20 79 6f 75 72 73 65 6c 66 20 63 6f 6d 66 6f 72 74 61 62 | n.please.make.yourself.comfortab |
| 40c0 | 6c 65 20 77 69 74 68 6f 75 74 20 72 75 6c 65 73 20 28 3a 72 65 66 3a 60 70 72 65 70 61 72 65 5f | le.without.rules.(:ref:`prepare_ |
| 40e0 | 63 6f 6d 6d 69 74 60 29 2e 00 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6d 6f 64 65 20 70 61 67 | commit`)..Configuration.mode.pag |
| 4100 | 65 73 00 43 72 65 61 74 65 20 61 20 6e 65 77 20 62 72 61 6e 63 68 20 66 6f 72 20 79 6f 75 72 20 | es.Create.a.new.branch.for.your. |
| 4120 | 77 6f 72 6b 2c 20 75 73 65 20 61 20 64 65 73 63 72 69 70 74 69 76 65 20 6e 61 6d 65 20 6f 66 20 | work,.use.a.descriptive.name.of. |
| 4140 | 79 6f 75 72 20 77 6f 72 6b 3a 20 60 60 24 20 67 69 74 20 63 68 65 63 6b 6f 75 74 20 2d 62 20 3c | your.work:.``$.git.checkout.-b.< |
| 4160 | 62 72 61 6e 63 68 2d 6e 61 6d 65 3e 60 60 00 43 72 6f 73 73 2d 52 65 66 65 72 65 6e 63 65 73 00 | branch-name>``.Cross-References. |
| 4180 | 43 75 73 74 6f 6d 20 53 70 68 69 6e 78 2d 64 6f 63 20 4d 61 72 6b 75 70 00 43 75 73 74 6f 6d 20 | Custom.Sphinx-doc.Markup.Custom. |
| 41a0 | 63 6f 6d 6d 61 6e 64 73 20 68 61 76 65 20 62 65 65 6e 20 64 65 76 65 6c 6f 70 65 64 20 66 6f 72 | commands.have.been.developed.for |
| 41c0 | 20 77 72 69 74 69 6e 67 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2e 20 50 6c 65 61 | .writing.the.documentation..Plea |
| 41e0 | 73 65 20 6d 61 6b 65 20 79 6f 75 72 73 65 6c 66 20 63 6f 6d 66 6f 72 74 61 62 6c 65 20 77 69 74 | se.make.yourself.comfortable.wit |
| 4200 | 68 20 74 68 6f 73 65 20 63 6f 6d 6d 61 6e 64 73 20 61 73 20 74 68 69 73 20 65 61 73 65 73 20 74 | h.those.commands.as.this.eases.t |
| 4220 | 68 65 20 77 61 79 20 77 65 20 72 65 6e 64 65 72 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 | he.way.we.render.the.documentati |
| 4240 | 6f 6e 2e 00 44 65 73 63 72 69 62 65 20 43 4c 49 20 69 74 65 6d 73 20 72 65 6c 61 74 65 64 20 74 | on..Describe.CLI.items.related.t |
| 4260 | 6f 20 74 68 65 20 73 65 72 76 69 63 65 20 6f 72 20 75 73 65 20 63 61 73 65 2e 20 45 61 63 68 20 | o.the.service.or.use.case..Each. |
| 4280 | 63 6f 6e 66 69 67 20 6c 69 6e 65 20 6f 72 20 73 65 63 74 69 6f 6e 20 6d 75 73 74 20 62 65 20 65 | config.line.or.section.must.be.e |
| 42a0 | 78 70 6c 61 69 6e 65 64 2c 20 75 73 69 6e 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 70 72 6f 76 | xplained,.using.information.prov |
| 42c0 | 69 64 65 64 20 69 6e 20 74 68 65 20 31 73 74 20 70 61 72 74 20 6f 66 20 74 68 65 20 70 61 67 65 | ided.in.the.1st.part.of.the.page |
| 42e0 | 2e 00 44 65 73 63 72 69 62 65 64 20 70 72 6f 63 65 64 75 72 65 73 20 66 6f 72 20 64 65 62 75 67 | ..Described.procedures.for.debug |
| 4300 | 67 69 6e 67 20 61 20 73 65 72 76 69 63 65 3a 00 44 6f 6e 27 74 20 66 6f 72 67 65 74 20 74 6f 20 | ging.a.service:.Don't.forget.to. |
| 4320 | 75 70 64 61 74 65 20 60 60 69 6e 64 65 78 2e 72 73 74 60 60 20 77 68 65 6e 20 61 64 64 69 6e 67 | update.``index.rst``.when.adding |
| 4340 | 20 61 20 6e 65 77 20 6e 6f 64 65 2e 00 45 61 63 68 20 47 69 74 48 75 62 20 70 75 6c 6c 20 72 65 | .a.new.node..Each.GitHub.pull.re |
| 4360 | 71 75 65 73 74 20 69 73 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 6c 69 6e 74 65 64 20 74 6f | quest.is.automatically.linted.to |
| 4380 | 20 63 68 65 63 6b 20 74 68 65 20 61 64 64 72 65 73 73 20 73 70 61 63 65 20 61 6e 64 20 6c 69 6e | .check.the.address.space.and.lin |
| 43a0 | 65 20 6c 65 6e 67 74 68 2e 00 45 61 63 68 20 70 61 67 65 20 6d 75 73 74 20 63 6f 6e 74 61 69 6e | e.length..Each.page.must.contain |
| 43c0 | 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 70 61 72 74 73 3a 00 45 78 63 65 70 74 20 69 6e 20 | .the.following.parts:.Except.in. |
| 43e0 | 60 60 2e 2e 20 63 6f 64 65 2d 62 6c 6f 63 6b 3a 3a 60 60 20 62 65 63 61 75 73 65 20 69 74 20 75 | ``...code-block::``.because.it.u |
| 4400 | 73 65 73 20 74 68 65 20 68 74 6d 6c 20 74 61 67 20 60 60 3c 70 72 65 3e 60 60 20 61 6e 64 20 72 | ses.the.html.tag.``<pre>``.and.r |
| 4420 | 65 6e 64 65 72 73 20 74 68 65 20 73 61 6d 65 20 6c 69 6e 65 20 66 6f 72 6d 61 74 20 66 72 6f 6d | enders.the.same.line.format.from |
| 4440 | 20 74 68 65 20 73 6f 75 72 63 65 20 72 73 74 20 66 69 6c 65 2e 00 46 6f 72 20 61 6e 20 69 6e 6c | .the.source.rst.file..For.an.inl |
| 4460 | 69 6e 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6c 65 76 65 6c 20 63 6f 6d 6d 61 6e 64 2c | ine.configuration.level.command, |
| 4480 | 20 75 73 65 20 60 60 3a 63 66 67 63 6d 64 3a 60 60 00 46 6f 72 20 61 6e 20 69 6e 6c 69 6e 65 20 | .use.``:cfgcmd:``.For.an.inline. |
| 44a0 | 6f 70 65 72 61 74 69 6f 6e 61 6c 20 6c 65 76 65 6c 20 63 6f 6d 6d 61 6e 64 2c 20 75 73 65 20 60 | operational.level.command,.use.` |
| 44c0 | 60 3a 6f 70 63 6d 64 3a 60 60 00 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 79 6f 75 20 77 61 6e 74 | `:opcmd:``.For.example,.you.want |
| 44e0 | 20 74 6f 20 72 65 66 65 72 65 6e 63 65 20 74 68 65 20 68 65 61 64 6c 69 6e 65 20 2a 2a 56 4c 41 | .to.reference.the.headline.**VLA |
| 4500 | 4e 2a 2a 20 69 6e 20 74 68 65 20 2a 2a 65 74 68 65 72 6e 65 74 2e 72 73 74 2a 2a 20 70 61 67 65 | N**.in.the.**ethernet.rst**.page |
| 4520 | 2e 20 54 68 65 20 70 6c 75 67 69 6e 20 67 65 6e 65 72 61 74 65 73 20 74 68 65 20 6c 61 62 65 6c | ..The.plugin.generates.the.label |
| 4540 | 20 62 61 73 65 64 20 6f 6e 20 74 68 65 20 68 65 61 64 6c 69 6e 65 20 61 6e 64 20 74 68 65 20 66 | .based.on.the.headline.and.the.f |
| 4560 | 69 6c 65 20 70 61 74 68 2e 00 46 6f 72 20 65 78 61 6d 70 6c 65 3a 00 46 6f 72 6b 20 74 68 69 73 | ile.path..For.example:.Fork.this |
| 4580 | 20 70 72 6f 6a 65 63 74 20 6f 6e 20 47 69 74 48 75 62 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 | .project.on.GitHub.https://githu |
| 45a0 | 62 2e 63 6f 6d 2f 76 79 6f 73 2f 76 79 6f 73 2d 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2f 66 6f | b.com/vyos/vyos-documentation/fo |
| 45c0 | 72 6b 00 46 6f 72 6b 69 6e 67 20 57 6f 72 6b 66 6c 6f 77 00 46 6f 72 6d 61 74 69 6e 67 20 61 6e | rk.Forking.Workflow.Formating.an |
| 45e0 | 64 20 53 70 68 69 6e 78 6d 61 72 6b 75 70 00 46 6f 72 6d 61 74 74 69 6e 67 20 61 6e 64 20 53 70 | d.Sphinxmarkup.Formatting.and.Sp |
| 4600 | 68 69 6e 78 6d 61 72 6b 75 70 00 47 65 6e 65 72 61 6c 20 63 6f 6e 63 65 70 74 73 20 66 6f 72 20 | hinxmarkup.General.concepts.for. |
| 4620 | 74 72 6f 75 62 6c 65 73 68 6f 6f 74 69 6e 67 20 61 6e 64 20 64 65 74 61 69 6c 65 64 20 70 72 6f | troubleshooting.and.detailed.pro |
| 4640 | 63 65 73 73 20 64 65 73 63 72 69 70 74 69 6f 6e 73 20 62 65 6c 6f 6e 67 20 68 65 72 65 2e 00 47 | cess.descriptions.belong.here..G |
| 4660 | 75 69 64 65 6c 69 6e 65 73 00 49 66 20 74 68 65 72 65 20 73 6f 6d 65 20 74 72 6f 75 62 6c 65 73 | uidelines.If.there.some.troubles |
| 4680 | 68 6f 6f 74 69 6e 67 20 67 75 69 64 65 73 20 72 65 6c 61 74 65 64 20 74 6f 20 74 68 65 20 63 6f | hooting.guides.related.to.the.co |
| 46a0 | 6d 6d 61 6e 64 73 2e 20 45 78 70 6c 61 69 6e 20 69 74 20 69 6e 20 74 68 65 20 6e 65 78 74 20 6f | mmands..Explain.it.in.the.next.o |
| 46c0 | 70 74 69 6f 6e 61 6c 20 70 61 72 74 2e 00 49 66 20 79 6f 75 20 61 6c 73 6f 20 77 61 6e 74 20 74 | ptional.part..If.you.also.want.t |
| 46e0 | 6f 20 75 70 64 61 74 65 20 79 6f 75 72 20 66 6f 72 6b 20 6f 6e 20 47 69 74 48 75 62 2c 20 75 73 | o.update.your.fork.on.GitHub,.us |
| 4700 | 65 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 3a 20 60 60 24 20 67 69 74 20 70 75 73 68 20 6f 72 | e.the.following:.``$.git.push.or |
| 4720 | 69 67 69 6e 20 6d 61 73 74 65 72 60 60 00 49 66 20 79 6f 75 20 61 72 65 20 77 69 6c 6c 69 6e 67 | igin.master``.If.you.are.willing |
| 4740 | 20 74 6f 20 63 6f 6e 74 72 69 62 75 74 65 20 74 6f 20 6f 75 72 20 64 6f 63 75 6d 65 6e 74 61 74 | .to.contribute.to.our.documentat |
| 4760 | 69 6f 6e 20 74 68 69 73 20 69 73 20 74 68 65 20 64 65 66 69 6e 69 74 65 20 67 75 69 64 65 20 68 | ion.this.is.the.definite.guide.h |
| 4780 | 6f 77 20 74 6f 20 64 6f 20 73 6f 2e 00 49 6e 20 63 6f 6e 74 72 61 73 74 20 74 6f 20 73 75 62 6d | ow.to.do.so..In.contrast.to.subm |
| 47a0 | 69 74 74 69 6e 67 20 63 6f 64 65 20 70 61 74 63 68 65 73 2c 20 74 68 65 72 65 20 69 73 20 6e 6f | itting.code.patches,.there.is.no |
| 47c0 | 20 72 65 71 75 69 72 65 6d 65 6e 74 20 74 68 61 74 20 79 6f 75 20 6f 70 65 6e 20 75 70 20 61 20 | .requirement.that.you.open.up.a. |
| 47e0 | 50 68 61 62 72 69 63 61 74 6f 72 5f 20 74 61 73 6b 20 70 72 69 6f 72 20 74 6f 20 73 75 62 6d 69 | Phabricator_.task.prior.to.submi |
| 4800 | 74 74 69 6e 67 20 61 20 50 75 6c 6c 2d 52 65 71 75 65 73 74 20 74 6f 20 74 68 65 20 64 6f 63 75 | tting.a.Pull-Request.to.the.docu |
| 4820 | 6d 65 6e 74 61 74 69 6f 6e 2e 00 49 6e 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 | mentation..In.the.configuration. |
| 4840 | 70 61 72 74 20 6f 66 20 74 68 65 20 70 61 67 65 2c 20 61 6c 6c 20 70 6f 73 73 69 62 6c 65 20 63 | part.of.the.page,.all.possible.c |
| 4860 | 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6f 70 74 69 6f 6e 73 20 73 68 6f 75 6c 64 20 62 65 20 64 | onfiguration.options.should.be.d |
| 4880 | 6f 63 75 6d 65 6e 74 65 64 2e 20 55 73 65 20 60 60 2e 2e 20 63 66 67 63 6d 64 3a 3a 60 60 20 64 | ocumented..Use.``...cfgcmd::``.d |
| 48a0 | 65 73 63 72 69 62 65 64 20 61 62 6f 76 65 2e 00 49 6e 64 65 6e 74 20 77 69 74 68 20 74 77 6f 20 | escribed.above..Indent.with.two. |
| 48c0 | 73 70 61 63 65 73 2e 00 49 6e 73 74 61 6c 6c 20 74 68 65 20 72 65 71 75 69 72 65 6d 65 6e 74 73 | spaces..Install.the.requirements |
| 48e0 | 20 60 60 24 20 70 69 70 20 69 6e 73 74 61 6c 6c 20 2d 72 20 72 65 71 75 69 72 65 6d 65 6e 74 73 | .``$.pip.install.-r.requirements |
| 4900 | 2e 74 78 74 60 60 20 28 6f 72 20 73 6f 6d 65 74 68 69 6e 67 20 73 69 6d 69 6c 61 72 29 00 4c 65 | .txt``.(or.something.similar).Le |
| 4920 | 61 76 65 20 61 20 6e 65 77 6c 69 6e 65 20 62 65 66 6f 72 65 20 61 6e 64 20 61 66 74 65 72 20 61 | ave.a.newline.before.and.after.a |
| 4940 | 20 68 65 61 64 65 72 2e 00 4c 69 6d 69 74 20 61 6c 6c 20 6c 69 6e 65 73 20 74 6f 20 61 20 6d 61 | .header..Limit.all.lines.to.a.ma |
| 4960 | 78 69 6d 75 6d 20 6f 66 20 38 30 20 63 68 61 72 61 63 74 65 72 73 2e 00 4c 69 6e 65 20 6c 65 6e | ximum.of.80.characters..Line.len |
| 4980 | 67 74 68 00 4d 61 6b 65 20 61 6c 6c 20 79 6f 75 72 20 63 68 61 6e 67 65 73 20 2d 20 70 6c 65 61 | gth.Make.all.your.changes.-.plea |
| 49a0 | 73 65 20 6b 65 65 70 20 6f 75 72 20 63 6f 6d 6d 69 74 20 72 75 6c 65 73 20 69 6e 20 6d 69 6e 64 | se.keep.our.commit.rules.in.mind |
| 49c0 | 20 28 3a 72 65 66 3a 60 70 72 65 70 61 72 65 5f 63 6f 6d 6d 69 74 60 29 2e 20 54 68 69 73 20 6d | .(:ref:`prepare_commit`)..This.m |
| 49e0 | 61 69 6e 6c 79 20 61 70 70 6c 69 65 73 20 74 6f 20 70 72 6f 70 65 72 20 63 6f 6d 6d 69 74 20 6d | ainly.applies.to.proper.commit.m |
| 4a00 | 65 73 73 61 67 65 73 20 64 65 73 63 72 69 62 69 6e 67 20 79 6f 75 72 20 63 68 61 6e 67 65 20 28 | essages.describing.your.change.( |
| 4a20 | 68 6f 77 20 61 6e 64 20 77 68 79 29 2e 20 50 6c 65 61 73 65 20 63 68 65 63 6b 20 6f 75 74 20 74 | how.and.why)..Please.check.out.t |
| 4a40 | 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 53 70 68 69 6e 78 2d 64 6f 63 5f 20 | he.documentation.of.Sphinx-doc_. |
| 4a60 | 6f 72 20 72 65 53 74 72 75 63 74 75 72 65 64 54 65 78 74 5f 20 69 66 20 79 6f 75 20 61 72 65 20 | or.reStructuredText_.if.you.are. |
| 4a80 | 6e 6f 74 20 66 61 6d 69 6c 69 61 72 20 77 69 74 68 20 69 74 2e 20 54 68 69 73 20 69 73 20 75 73 | not.familiar.with.it..This.is.us |
| 4aa0 | 65 64 20 66 6f 72 20 77 72 69 74 69 6e 67 20 6f 75 72 20 64 6f 63 73 2e 20 41 64 64 69 74 69 6f | ed.for.writing.our.docs..Additio |
| 4ac0 | 6e 61 6c 20 64 69 72 65 63 74 69 76 65 73 20 68 6f 77 20 74 6f 20 77 72 69 74 65 20 69 6e 20 52 | nal.directives.how.to.write.in.R |
| 4ae0 | 53 54 20 63 61 6e 20 62 65 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 72 65 53 74 72 75 63 74 | ST.can.be.obtained.from.reStruct |
| 4b00 | 75 72 65 64 54 65 78 74 44 69 72 65 63 74 69 76 65 73 5f 2e 00 4d 75 6c 74 69 63 61 73 74 20 4d | uredTextDirectives_..Multicast.M |
| 4b20 | 41 43 2d 41 64 64 72 65 73 73 65 73 3a 20 60 60 39 30 2d 31 30 2d 30 30 60 60 20 74 6f 20 60 60 | AC-Addresses:.``90-10-00``.to.`` |
| 4b40 | 39 30 2d 31 30 2d 46 46 60 60 00 4e 6f 74 65 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 52 46 | 90-10-FF``.Note.the.following.RF |
| 4b60 | 43 73 20 28 3a 72 66 63 3a 60 35 37 33 37 60 2c 20 3a 72 66 63 3a 60 33 38 34 39 60 2c 20 3a 72 | Cs.(:rfc:`5737`,.:rfc:`3849`,.:r |
| 4b80 | 66 63 3a 60 35 33 38 39 60 20 61 6e 64 20 3a 72 66 63 3a 60 37 30 34 32 60 29 2c 20 77 68 69 63 | fc:`5389`.and.:rfc:`7042`),.whic |
| 4ba0 | 68 20 64 65 73 63 72 69 62 65 20 74 68 65 20 72 65 73 65 72 76 65 64 20 70 75 62 6c 69 63 20 49 | h.describe.the.reserved.public.I |
| 4bc0 | 50 20 61 64 64 72 65 73 73 65 73 20 61 6e 64 20 61 75 74 6f 6e 6f 6d 6f 75 73 20 73 79 73 74 65 | P.addresses.and.autonomous.syste |
| 4be0 | 6d 20 6e 75 6d 62 65 72 73 20 66 6f 72 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 3a | m.numbers.for.the.documentation: |
| 4c00 | 00 4f 6e 63 65 20 70 75 6c 6c 20 72 65 71 75 65 73 74 73 20 68 61 76 65 20 62 65 65 6e 20 61 70 | .Once.pull.requests.have.been.ap |
| 4c20 | 70 72 6f 76 65 64 2c 20 79 6f 75 20 6d 61 79 20 77 61 6e 74 20 74 6f 20 6c 6f 63 61 6c 6c 79 20 | proved,.you.may.want.to.locally. |
| 4c40 | 75 70 64 61 74 65 20 79 6f 75 72 20 66 6f 72 6b 65 64 20 72 65 70 6f 73 69 74 6f 72 79 20 74 6f | update.your.forked.repository.to |
| 4c60 | 6f 2e 20 46 69 72 73 74 20 79 6f 75 27 6c 6c 20 68 61 76 65 20 74 6f 20 61 64 64 20 61 20 73 65 | o..First.you'll.have.to.add.a.se |
| 4c80 | 63 6f 6e 64 20 72 65 6d 6f 74 65 20 63 61 6c 6c 65 64 20 60 75 70 73 74 72 65 61 6d 60 20 77 68 | cond.remote.called.`upstream`.wh |
| 4ca0 | 69 63 68 20 70 6f 69 6e 74 73 20 74 6f 20 6f 75 72 20 6d 61 69 6e 20 72 65 70 6f 73 69 74 6f 72 | ich.points.to.our.main.repositor |
| 4cc0 | 79 2e 20 60 60 24 20 67 69 74 20 72 65 6d 6f 74 65 20 61 64 64 20 75 70 73 74 72 65 61 6d 20 68 | y..``$.git.remote.add.upstream.h |
| 4ce0 | 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 76 79 6f 73 2f 76 79 6f 73 2d 64 6f 63 75 | ttps://github.com/vyos/vyos-docu |
| 4d00 | 6d 65 6e 74 61 74 69 6f 6e 2e 67 69 74 60 60 00 4f 70 65 72 61 74 69 6f 6e 20 6d 6f 64 65 20 63 | mentation.git``.Operation.mode.c |
| 4d20 | 6f 6d 6d 61 6e 64 73 20 74 68 61 74 20 64 6f 20 6e 6f 74 20 66 69 74 20 69 6e 20 61 20 72 65 6c | ommands.that.do.not.fit.in.a.rel |
| 4d40 | 61 74 65 64 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6d 6f 64 65 20 63 6f 6d 6d 61 6e 64 20 | ated.configuration.mode.command. |
| 4d60 | 6d 75 73 74 20 62 65 20 64 6f 63 75 6d 65 6e 74 65 64 20 69 6e 20 74 68 69 73 20 70 61 72 74 20 | must.be.documented.in.this.part. |
| 4d80 | 6f 66 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2e 00 4f 70 65 72 61 74 69 6f 6e 20 | of.the.documentation..Operation. |
| 4da0 | 6d 6f 64 65 20 70 61 67 65 73 00 50 61 67 65 20 63 6f 6e 74 65 6e 74 00 50 6c 65 61 73 65 20 64 | mode.pages.Page.content.Please.d |
| 4dc0 | 6f 20 6e 6f 74 20 75 73 65 20 6f 74 68 65 72 20 70 75 62 6c 69 63 20 61 64 64 72 65 73 73 20 73 | o.not.use.other.public.address.s |
| 4de0 | 70 61 63 65 2e 00 50 72 61 63 74 69 63 61 6c 20 65 78 61 6d 70 6c 65 73 20 6f 66 20 74 68 65 20 | pace..Practical.examples.of.the. |
| 4e00 | 73 65 72 76 69 63 65 20 6f 72 20 75 73 65 20 63 61 73 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f | service.or.use.case.configuratio |
| 4e20 | 6e 2e 20 54 68 65 79 20 6d 75 73 74 20 63 6f 6e 74 61 69 6e 20 74 6f 70 6f 6c 6f 67 79 20 6d 61 | n..They.must.contain.topology.ma |
| 4e40 | 70 73 20 28 69 66 20 61 70 70 6c 69 63 61 62 6c 65 29 20 61 6e 64 20 73 68 6f 72 74 20 64 65 73 | ps.(if.applicable).and.short.des |
| 4e60 | 63 72 69 70 74 69 6f 6e 73 2e 00 50 72 6f 70 65 72 6c 79 20 71 75 6f 74 65 20 63 6f 6d 6d 61 6e | criptions..Properly.quote.comman |
| 4e80 | 64 73 2c 20 66 69 6c 65 6e 61 6d 65 73 20 61 6e 64 20 62 72 69 65 66 20 63 6f 64 65 20 73 6e 69 | ds,.filenames.and.brief.code.sni |
| 4ea0 | 70 70 65 74 73 20 77 69 74 68 20 64 6f 75 62 6c 65 20 62 61 63 6b 74 69 63 6b 73 2e 00 50 75 73 | ppets.with.double.backticks..Pus |
| 4ec0 | 68 20 63 6f 6d 6d 69 74 73 20 74 6f 20 79 6f 75 72 20 47 69 74 48 75 62 20 70 72 6f 6a 65 63 74 | h.commits.to.your.GitHub.project |
| 4ee0 | 3a 20 60 60 24 20 67 69 74 20 70 75 73 68 20 2d 75 20 6f 72 69 67 69 6e 20 3c 62 72 61 6e 63 68 | :.``$.git.push.-u.origin.<branch |
| 4f00 | 2d 6e 61 6d 65 3e 60 60 00 52 65 6c 61 74 65 64 20 6f 70 65 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 | -name>``.Related.operation.comma |
| 4f20 | 6e 64 20 6d 75 73 74 20 62 65 20 64 6f 63 75 6d 65 6e 74 65 64 20 69 6e 20 74 68 65 20 6e 65 78 | nd.must.be.documented.in.the.nex |
| 4f40 | 74 20 70 61 72 74 20 6f 66 20 74 68 65 20 61 72 74 69 63 6c 65 2e 20 55 73 65 20 60 60 3a 3a 6f | t.part.of.the.article..Use.``::o |
| 4f60 | 70 63 6d 64 2e 2e 60 60 20 66 6f 72 20 74 68 65 73 65 20 63 6f 6d 6d 61 6e 64 73 2e 00 53 6f 6d | pcmd..``.for.these.commands..Som |
| 4f80 | 65 74 69 6d 65 73 20 69 74 20 69 73 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 70 72 6f 76 69 64 | etimes.it.is.necessary.to.provid |
| 4fa0 | 65 20 72 65 61 6c 20 49 50 20 61 64 64 72 65 73 73 65 73 20 6c 69 6b 65 20 69 6e 20 74 68 65 20 | e.real.IP.addresses.like.in.the. |
| 4fc0 | 3a 72 65 66 3a 60 65 78 61 6d 70 6c 65 73 60 2e 20 46 6f 72 20 74 68 69 73 2c 20 70 6c 65 61 73 | :ref:`examples`..For.this,.pleas |
| 4fe0 | 65 20 75 73 65 20 74 68 65 20 73 70 68 69 6e 78 20 63 6f 6d 6d 65 6e 74 20 73 79 6e 74 61 78 20 | e.use.the.sphinx.comment.syntax. |
| 5000 | 60 60 2e 2e 20 73 74 6f 70 5f 76 79 6f 73 6c 69 6e 74 65 72 60 60 20 74 6f 20 73 74 6f 70 20 74 | ``...stop_vyoslinter``.to.stop.t |
| 5020 | 68 65 20 6c 69 6e 74 65 72 20 61 6e 64 20 60 60 2e 2e 20 73 74 61 72 74 5f 76 79 6f 73 6c 69 6e | he.linter.and.``...start_vyoslin |
| 5040 | 74 65 72 60 60 20 74 6f 20 73 74 61 72 74 2e 00 53 74 79 6c 65 20 47 75 69 64 65 00 53 75 62 6d | ter``.to.start..Style.Guide.Subm |
| 5060 | 69 74 20 70 75 6c 6c 2d 72 65 71 75 65 73 74 2e 20 49 6e 20 47 69 74 48 75 62 20 76 69 73 69 74 | it.pull-request..In.GitHub.visit |
| 5080 | 20 74 68 65 20 6d 61 69 6e 20 72 65 70 6f 73 69 74 6f 72 79 20 61 6e 64 20 79 6f 75 20 73 68 6f | .the.main.repository.and.you.sho |
| 50a0 | 75 6c 64 20 73 65 65 20 61 20 62 61 6e 6e 65 72 20 73 75 67 67 65 73 74 69 6e 67 20 74 6f 20 6d | uld.see.a.banner.suggesting.to.m |
| 50c0 | 61 6b 65 20 61 20 70 75 6c 6c 20 72 65 71 75 65 73 74 2e 20 46 69 6c 6c 20 6f 75 74 20 74 68 65 | ake.a.pull.request..Fill.out.the |
| 50e0 | 20 66 6f 72 6d 20 61 6e 64 20 64 65 73 63 72 69 62 65 20 77 68 61 74 20 79 6f 75 20 64 6f 2e 00 | .form.and.describe.what.you.do.. |
| 5100 | 54 4f 43 20 4c 65 76 65 6c 00 54 61 6b 65 20 61 20 6c 6f 6f 6b 20 61 74 20 74 68 65 20 3a 64 6f | TOC.Level.Take.a.look.at.the.:do |
| 5120 | 63 3a 60 2f 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 60 20 70 61 67 65 20 66 6f 72 20 61 6e 20 69 | c:`/documentation`.page.for.an.i |
| 5140 | 6e 74 72 69 63 61 74 65 20 65 78 70 6c 61 6e 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 64 6f 63 75 | ntricate.explanation.of.the.docu |
| 5160 | 6d 65 6e 74 61 74 69 6f 6e 20 70 72 6f 63 65 73 73 2e 00 54 68 65 20 46 6f 72 6b 69 6e 67 20 57 | mentation.process..The.Forking.W |
| 5180 | 6f 72 6b 66 6c 6f 77 20 69 73 20 66 75 6e 64 61 6d 65 6e 74 61 6c 6c 79 20 64 69 66 66 65 72 65 | orkflow.is.fundamentally.differe |
| 51a0 | 6e 74 20 66 72 6f 6d 20 6f 74 68 65 72 20 70 6f 70 75 6c 61 72 20 47 69 74 20 77 6f 72 6b 66 6c | nt.from.other.popular.Git.workfl |
| 51c0 | 6f 77 73 2e 20 49 6e 73 74 65 61 64 20 6f 66 20 75 73 69 6e 67 20 61 20 73 69 6e 67 6c 65 20 73 | ows..Instead.of.using.a.single.s |
| 51e0 | 65 72 76 65 72 2d 73 69 64 65 20 72 65 70 6f 73 69 74 6f 72 79 20 74 6f 20 61 63 74 20 61 73 20 | erver-side.repository.to.act.as. |
| 5200 | 74 68 65 20 22 63 65 6e 74 72 61 6c 22 20 63 6f 64 65 62 61 73 65 2c 20 69 74 20 67 69 76 65 73 | the."central".codebase,.it.gives |
| 5220 | 20 65 76 65 72 79 20 64 65 76 65 6c 6f 70 65 72 20 74 68 65 69 72 20 6f 77 6e 20 73 65 72 76 65 | .every.developer.their.own.serve |
| 5240 | 72 2d 73 69 64 65 20 72 65 70 6f 73 69 74 6f 72 79 2e 20 54 68 69 73 20 6d 65 61 6e 73 20 74 68 | r-side.repository..This.means.th |
| 5260 | 61 74 20 65 61 63 68 20 63 6f 6e 74 72 69 62 75 74 6f 72 20 68 61 73 20 6e 6f 74 20 6f 6e 65 2c | at.each.contributor.has.not.one, |
| 5280 | 20 62 75 74 20 74 77 6f 20 47 69 74 20 72 65 70 6f 73 69 74 6f 72 69 65 73 3a 20 61 20 70 72 69 | .but.two.Git.repositories:.a.pri |
| 52a0 | 76 61 74 65 20 6c 6f 63 61 6c 20 6f 6e 65 20 61 6e 64 20 61 20 70 75 62 6c 69 63 20 73 65 72 76 | vate.local.one.and.a.public.serv |
| 52c0 | 65 72 2d 73 69 64 65 20 6f 6e 65 2e 00 54 68 65 20 61 72 74 69 63 6c 65 20 73 74 61 72 74 73 20 | er-side.one..The.article.starts. |
| 52e0 | 77 69 74 68 20 61 20 73 68 6f 72 74 20 69 6e 74 72 6f 64 75 63 74 69 6f 6e 20 61 62 6f 75 74 20 | with.a.short.introduction.about. |
| 5300 | 74 68 65 20 63 6f 6d 6d 61 6e 64 20 6f 72 20 74 68 65 20 74 65 63 68 6e 6f 6c 6f 67 79 2e 20 50 | the.command.or.the.technology..P |
| 5320 | 6c 65 61 73 65 20 69 6e 63 6c 75 64 65 20 73 6f 6d 65 20 68 65 6c 70 66 75 6c 20 6c 69 6e 6b 73 | lease.include.some.helpful.links |
| 5340 | 20 6f 72 20 62 61 63 6b 67 72 6f 75 6e 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 00 54 68 65 20 | .or.background.information..The. |
| 5360 | 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6d 6f 64 65 20 66 6f 6c 64 65 72 20 61 6e 64 20 74 68 | configuration.mode.folder.and.th |
| 5380 | 65 20 61 72 74 69 63 6c 65 73 20 63 6f 76 65 72 20 74 68 65 20 73 70 65 63 69 66 69 63 20 6c 65 | e.articles.cover.the.specific.le |
| 53a0 | 76 65 6c 20 6f 66 20 74 68 65 20 63 6f 6d 6d 61 6e 64 73 2e 20 54 68 65 20 65 78 61 63 74 20 6c | vel.of.the.commands..The.exact.l |
| 53c0 | 65 76 65 6c 20 64 65 70 65 6e 64 73 20 6f 6e 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2e 20 54 68 69 | evel.depends.on.the.command..Thi |
| 53e0 | 73 20 73 68 6f 75 6c 64 20 70 72 6f 76 69 64 65 20 73 74 61 62 69 6c 69 74 79 20 66 6f 72 20 55 | s.should.provide.stability.for.U |
| 5400 | 52 4c 73 20 75 73 65 64 20 69 6e 20 74 68 65 20 66 6f 72 75 6d 20 6f 72 20 62 6c 6f 67 70 6f 73 | RLs.used.in.the.forum.or.blogpos |
| 5420 | 74 2e 00 54 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 68 61 73 20 33 20 64 69 66 66 65 | t..The.documentation.has.3.diffe |
| 5440 | 72 65 6e 74 20 74 79 70 65 73 20 6f 66 20 70 61 67 65 73 2e 20 54 68 65 20 73 61 6d 65 20 6b 69 | rent.types.of.pages..The.same.ki |
| 5460 | 6e 64 20 6f 66 20 70 61 67 65 73 20 6d 75 73 74 20 68 61 76 65 20 74 68 65 20 73 61 6d 65 20 73 | nd.of.pages.must.have.the.same.s |
| 5480 | 74 72 75 63 74 75 72 65 20 74 6f 20 61 63 68 69 65 76 65 20 61 20 72 65 63 6f 67 6e 69 74 69 6f | tructure.to.achieve.a.recognitio |
| 54a0 | 6e 20 66 61 63 74 6f 72 2e 00 54 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 73 6f 75 72 | n.factor..The.documentation.sour |
| 54c0 | 63 65 20 69 73 20 6b 65 70 74 20 69 6e 20 74 68 65 20 47 69 74 20 72 65 70 6f 73 69 74 6f 72 79 | ce.is.kept.in.the.Git.repository |
| 54e0 | 20 61 74 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 76 79 6f 73 2f 76 79 6f 73 | .at.https://github.com/vyos/vyos |
| 5500 | 2d 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 61 6e 64 20 79 6f 75 20 63 61 6e 20 66 6f 6c 6c 6f | -documentation.and.you.can.follo |
| 5520 | 77 20 74 68 65 20 69 6e 73 74 72 75 63 74 69 6f 6e 73 20 69 6e 20 74 68 65 20 52 45 41 44 4d 45 | w.the.instructions.in.the.README |
| 5540 | 2e 6d 64 5f 20 74 6f 20 62 75 69 6c 64 20 61 6e 64 20 74 65 73 74 20 79 6f 75 72 20 63 68 61 6e | .md_.to.build.and.test.your.chan |
| 5560 | 67 65 73 2e 00 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 73 20 61 20 71 75 69 63 6b 20 73 75 | ges..The.following.is.a.quick.su |
| 5580 | 6d 6d 61 72 79 20 6f 66 20 74 68 65 20 72 75 6c 65 73 3a 00 54 68 65 20 6d 61 69 6e 20 61 64 76 | mmary.of.the.rules:.The.main.adv |
| 55a0 | 61 6e 74 61 67 65 20 6f 66 20 74 68 65 20 46 6f 72 6b 69 6e 67 20 57 6f 72 6b 66 6c 6f 77 20 69 | antage.of.the.Forking.Workflow.i |
| 55c0 | 73 20 74 68 61 74 20 63 6f 6e 74 72 69 62 75 74 69 6f 6e 73 20 63 61 6e 20 62 65 20 69 6e 74 65 | s.that.contributions.can.be.inte |
| 55e0 | 67 72 61 74 65 64 20 77 69 74 68 6f 75 74 20 74 68 65 20 6e 65 65 64 20 66 6f 72 20 65 76 65 72 | grated.without.the.need.for.ever |
| 5600 | 79 62 6f 64 79 20 74 6f 20 70 75 73 68 20 74 6f 20 61 20 73 69 6e 67 6c 65 20 63 65 6e 74 72 61 | ybody.to.push.to.a.single.centra |
| 5620 | 6c 20 72 65 70 6f 73 69 74 6f 72 79 2e 20 44 65 76 65 6c 6f 70 65 72 73 20 70 75 73 68 20 74 6f | l.repository..Developers.push.to |
| 5640 | 20 74 68 65 69 72 20 6f 77 6e 20 73 65 72 76 65 72 2d 73 69 64 65 20 72 65 70 6f 73 69 74 6f 72 | .their.own.server-side.repositor |
| 5660 | 69 65 73 2c 20 61 6e 64 20 6f 6e 6c 79 20 74 68 65 20 70 72 6f 6a 65 63 74 20 6d 61 69 6e 74 61 | ies,.and.only.the.project.mainta |
| 5680 | 69 6e 65 72 20 63 61 6e 20 70 75 73 68 20 74 6f 20 74 68 65 20 6f 66 66 69 63 69 61 6c 20 72 65 | iner.can.push.to.the.official.re |
| 56a0 | 70 6f 73 69 74 6f 72 79 2e 20 54 68 69 73 20 61 6c 6c 6f 77 73 20 74 68 65 20 6d 61 69 6e 74 61 | pository..This.allows.the.mainta |
| 56c0 | 69 6e 65 72 20 74 6f 20 61 63 63 65 70 74 20 63 6f 6d 6d 69 74 73 20 66 72 6f 6d 20 61 6e 79 20 | iner.to.accept.commits.from.any. |
| 56e0 | 64 65 76 65 6c 6f 70 65 72 20 77 69 74 68 6f 75 74 20 67 69 76 69 6e 67 20 74 68 65 6d 20 77 72 | developer.without.giving.them.wr |
| 5700 | 69 74 65 20 61 63 63 65 73 73 20 74 6f 20 74 68 65 20 6f 66 66 69 63 69 61 6c 20 63 6f 64 65 62 | ite.access.to.the.official.codeb |
| 5720 | 61 73 65 2e 00 54 68 65 20 70 6c 75 67 69 6e 20 77 69 6c 6c 20 77 61 72 6e 20 6f 6e 20 62 75 69 | ase..The.plugin.will.warn.on.bui |
| 5740 | 6c 64 20 69 66 20 61 20 68 65 61 64 6c 69 6e 65 20 68 61 73 20 61 20 64 75 70 6c 69 63 61 74 65 | ld.if.a.headline.has.a.duplicate |
| 5760 | 20 6e 61 6d 65 20 69 6e 20 74 68 65 20 73 61 6d 65 20 64 6f 63 75 6d 65 6e 74 2e 20 54 6f 20 70 | .name.in.the.same.document..To.p |
| 5780 | 72 65 76 65 6e 74 20 74 68 69 73 20 77 61 72 6e 69 6e 67 2c 20 79 6f 75 20 68 61 76 65 20 74 6f | revent.this.warning,.you.have.to |
| 57a0 | 20 70 75 74 20 61 20 63 75 73 74 6f 6d 20 6c 69 6e 6b 20 6f 6e 20 74 6f 70 20 6f 66 20 74 68 65 | .put.a.custom.link.on.top.of.the |
| 57c0 | 20 68 65 61 64 6c 69 6e 65 2e 00 54 68 65 6f 72 65 74 69 63 61 6c 20 69 6e 66 6f 72 6d 61 74 69 | .headline..Theoretical.informati |
| 57e0 | 6f 6e 20 72 65 71 75 69 72 65 64 20 66 6f 72 20 75 73 65 72 73 20 74 6f 20 75 6e 64 65 72 73 74 | on.required.for.users.to.underst |
| 5800 | 61 6e 64 20 74 68 65 20 6e 65 78 74 20 64 6f 63 75 6d 65 6e 74 20 73 65 63 74 69 6f 6e 73 3a 00 | and.the.next.document.sections:. |
| 5820 | 54 68 65 72 65 20 61 72 65 20 61 20 66 65 77 20 74 68 69 6e 67 73 20 74 6f 20 6b 65 65 70 20 69 | There.are.a.few.things.to.keep.i |
| 5840 | 6e 20 6d 69 6e 64 20 77 68 65 6e 20 63 6f 6e 74 72 69 62 75 74 69 6e 67 20 74 6f 20 74 68 65 20 | n.mind.when.contributing.to.the. |
| 5860 | 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2c 20 66 6f 72 20 74 68 65 20 73 61 6b 65 20 6f 66 20 63 | documentation,.for.the.sake.of.c |
| 5880 | 6f 6e 73 69 73 74 65 6e 63 79 20 61 6e 64 20 72 65 61 64 61 62 69 6c 69 74 79 2e 00 54 68 69 73 | onsistency.and.readability..This |
| 58a0 | 20 73 65 63 74 69 6f 6e 20 6d 75 73 74 20 63 6f 6e 74 61 69 6e 20 61 20 6c 69 73 74 20 6f 66 3a | .section.must.contain.a.list.of: |
| 58c0 | 00 54 6f 20 65 78 74 72 61 63 74 20 61 20 64 65 66 61 75 6c 74 76 61 6c 75 65 20 66 72 6f 6d 20 | .To.extract.a.defaultvalue.from. |
| 58e0 | 74 68 65 20 58 4d 4c 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 61 64 64 20 61 20 60 60 3a 64 65 66 | the.XML.definitions.add.a.``:def |
| 5900 | 61 75 6c 74 76 61 6c 75 65 3a 60 60 20 74 6f 20 60 60 2e 2e 20 63 66 67 63 6d 64 3a 3a 60 60 20 | aultvalue:``.to.``...cfgcmd::``. |
| 5920 | 64 69 72 65 63 74 69 76 65 2e 20 54 6f 20 68 61 76 65 20 74 68 69 73 20 66 65 61 74 75 72 65 20 | directive..To.have.this.feature. |
| 5940 | 6c 6f 63 61 6c 6c 79 2c 20 74 68 65 20 76 79 6f 73 2d 31 78 20 73 75 62 6d 6f 64 75 6c 65 20 6d | locally,.the.vyos-1x.submodule.m |
| 5960 | 75 73 74 20 62 65 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 62 65 66 6f 72 65 2e 20 50 6c 65 61 73 | ust.be.initialized.before..Pleas |
| 5980 | 65 20 62 65 20 61 77 61 72 65 20 74 6f 20 6e 6f 74 20 75 70 64 61 74 65 20 74 68 65 20 73 75 62 | e.be.aware.to.not.update.the.sub |
| 59a0 | 6d 6f 64 75 6c 65 20 69 6e 20 79 6f 75 72 20 50 52 2e 00 54 6f 20 6d 69 6e 69 6d 69 7a 65 20 72 | module.in.your.PR..To.minimize.r |
| 59c0 | 65 64 75 6e 64 61 6e 63 79 2c 20 74 68 65 72 65 20 69 73 20 61 20 73 70 65 63 69 61 6c 20 69 6e | edundancy,.there.is.a.special.in |
| 59e0 | 63 6c 75 64 65 20 64 69 72 65 63 74 69 76 65 2e 20 49 74 20 69 6e 63 6c 75 64 65 73 20 61 20 74 | clude.directive..It.includes.a.t |
| 5a00 | 78 74 20 66 69 6c 65 20 61 6e 64 20 72 65 70 6c 61 63 65 20 74 68 65 20 60 60 7b 7b 20 76 61 72 | xt.file.and.replace.the.``{{.var |
| 5a20 | 30 20 7d 7d 60 60 20 2d 20 60 60 7b 7b 20 76 61 72 39 20 7d 7d 60 60 20 77 69 74 68 20 74 68 65 | 0.}}``.-.``{{.var9.}}``.with.the |
| 5a40 | 20 63 6f 72 72 65 63 74 20 76 61 6c 75 65 2e 00 54 72 79 20 6e 6f 74 20 74 6f 20 65 78 63 65 65 | .correct.value..Try.not.to.excee |
| 5a60 | 64 20 38 30 20 63 68 61 72 61 63 74 65 72 73 20 70 65 72 20 6c 69 6e 65 2c 20 62 75 74 20 64 6f | d.80.characters.per.line,.but.do |
| 5a80 | 6e 27 74 20 62 72 65 61 6b 20 55 52 4c 73 20 6f 76 65 72 20 74 68 69 73 2e 00 55 6e 69 63 61 73 | n't.break.URLs.over.this..Unicas |
| 5aa0 | 74 20 4d 41 43 20 41 64 64 72 65 73 73 65 73 3a 20 60 60 30 30 2d 35 33 2d 30 30 60 60 20 74 6f | t.MAC.Addresses:.``00-53-00``.to |
| 5ac0 | 20 60 60 30 30 2d 35 33 2d 46 46 60 60 00 55 70 64 61 74 65 73 20 74 6f 20 6f 75 72 20 64 6f 63 | .``00-53-FF``.Updates.to.our.doc |
| 5ae0 | 75 6d 65 6e 74 61 74 69 6f 6e 20 73 68 6f 75 6c 64 20 62 65 20 64 65 6c 69 76 65 72 65 64 20 62 | umentation.should.be.delivered.b |
| 5b00 | 79 20 61 20 47 69 74 48 75 62 20 70 75 6c 6c 2d 72 65 71 75 65 73 74 2e 20 54 68 69 73 20 72 65 | y.a.GitHub.pull-request..This.re |
| 5b20 | 71 75 69 72 65 73 20 79 6f 75 20 61 6c 72 65 61 64 79 20 68 61 76 65 20 61 20 47 69 74 48 75 62 | quires.you.already.have.a.GitHub |
| 5b40 | 20 61 63 63 6f 75 6e 74 2e 00 55 73 65 20 41 6d 65 72 69 63 61 6e 20 45 6e 67 6c 69 73 68 20 61 | .account..Use.American.English.a |
| 5b60 | 74 20 61 6c 6c 20 74 69 6d 65 73 2e 20 49 74 27 73 20 61 6c 77 61 79 73 20 61 20 67 6f 6f 64 20 | t.all.times..It's.always.a.good. |
| 5b80 | 69 64 65 61 20 74 6f 20 72 75 6e 20 79 6f 75 72 20 74 65 78 74 20 74 68 72 6f 75 67 68 20 61 20 | idea.to.run.your.text.through.a. |
| 5ba0 | 67 72 61 6d 6d 61 72 20 61 6e 64 20 73 70 65 6c 6c 20 63 68 65 63 6b 65 72 2c 20 73 75 63 68 20 | grammar.and.spell.checker,.such. |
| 5bc0 | 61 73 20 60 47 72 61 6d 6d 61 72 6c 79 60 5f 2e 00 55 73 65 20 6c 69 74 65 72 61 6c 20 62 6c 6f | as.`Grammarly`_..Use.literal.blo |
| 5be0 | 63 6b 73 20 66 6f 72 20 6c 6f 6e 67 65 72 20 73 6e 69 70 70 65 74 73 2e 00 56 69 65 77 20 6d 6f | cks.for.longer.snippets..View.mo |
| 5c00 | 64 69 66 69 65 64 20 66 69 6c 65 73 20 62 79 20 63 61 6c 6c 69 6e 67 20 60 60 24 20 67 69 74 20 | dified.files.by.calling.``$.git. |
| 5c20 | 73 74 61 74 75 73 60 60 2e 20 59 6f 75 20 77 69 6c 6c 20 67 65 74 20 61 6e 20 6f 76 65 72 76 69 | status``..You.will.get.an.overvi |
| 5c40 | 65 77 20 6f 66 20 61 6c 6c 20 66 69 6c 65 73 20 6d 6f 64 69 66 69 65 64 20 62 79 20 79 6f 75 2e | ew.of.all.files.modified.by.you. |
| 5c60 | 20 59 6f 75 20 63 61 6e 20 61 64 64 20 69 6e 64 69 76 69 64 75 61 6c 20 66 69 6c 65 73 20 74 6f | .You.can.add.individual.files.to |
| 5c80 | 20 74 68 65 20 47 69 74 20 49 6e 64 65 78 20 69 6e 20 74 68 65 20 6e 65 78 74 20 73 74 65 70 2e | .the.Git.Index.in.the.next.step. |
| 5ca0 | 00 56 79 4f 53 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 69 73 20 77 72 69 74 74 65 6e 20 69 | .VyOS.documentation.is.written.i |
| 5cc0 | 6e 20 72 65 53 74 72 75 63 74 75 72 65 64 54 65 78 74 20 61 6e 64 20 67 65 6e 65 72 61 74 65 64 | n.reStructuredText.and.generated |
| 5ce0 | 20 74 6f 20 52 65 61 64 20 74 68 65 20 44 6f 63 73 20 70 61 67 65 73 20 77 69 74 68 20 53 70 68 | .to.Read.the.Docs.pages.with.Sph |
| 5d00 | 69 6e 78 2c 20 61 73 20 70 65 72 20 74 68 65 20 50 79 74 68 6f 6e 20 74 72 61 64 69 74 69 6f 6e | inx,.as.per.the.Python.tradition |
| 5d20 | 2c 20 61 73 20 77 65 6c 6c 20 61 73 20 50 44 46 20 66 69 6c 65 73 20 66 6f 72 20 6f 66 66 6c 69 | ,.as.well.as.PDF.files.for.offli |
| 5d40 | 6e 65 20 75 73 65 20 74 68 72 6f 75 67 68 20 4c 61 54 65 58 2e 20 57 65 20 77 65 6c 63 6f 6d 65 | ne.use.through.LaTeX..We.welcome |
| 5d60 | 20 61 6c 6c 20 73 6f 72 74 73 20 6f 66 20 63 6f 6e 74 72 69 62 75 74 69 6f 6e 73 20 74 6f 20 74 | .all.sorts.of.contributions.to.t |
| 5d80 | 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2e 20 4e 6f 74 20 6a 75 73 74 20 6e 65 77 20 61 | he.documentation..Not.just.new.a |
| 5da0 | 64 64 69 74 69 6f 6e 73 20 62 75 74 20 61 6c 73 6f 20 63 6f 72 72 65 63 74 69 6f 6e 73 20 74 6f | dditions.but.also.corrections.to |
| 5dc0 | 20 65 78 69 73 74 69 6e 67 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2e 00 56 79 4f 53 20 64 6f | .existing.documentation..VyOS.do |
| 5de0 | 63 75 6d 65 6e 74 61 74 69 6f 6e 20 69 73 20 77 72 69 74 74 65 6e 20 69 6e 20 72 65 53 74 72 75 | cumentation.is.written.in.reStru |
| 5e00 | 63 74 75 72 65 64 54 65 78 74 20 61 6e 64 20 67 65 6e 65 72 61 74 65 64 20 74 6f 20 52 65 61 64 | cturedText.and.generated.to.Read |
| 5e20 | 20 74 68 65 20 44 6f 63 73 20 70 61 67 65 73 20 77 69 74 68 20 53 70 68 69 6e 78 2c 20 61 73 20 | .the.Docs.pages.with.Sphinx,.as. |
| 5e40 | 70 65 72 20 74 68 65 20 50 79 74 68 6f 6e 20 74 72 61 64 69 74 69 6f 6e 2e 20 57 65 20 77 65 6c | per.the.Python.tradition..We.wel |
| 5e60 | 63 6f 6d 65 20 61 6c 6c 20 73 6f 72 74 73 20 6f 66 20 63 6f 6e 74 72 69 62 75 74 69 6f 6e 73 20 | come.all.sorts.of.contributions. |
| 5e80 | 74 6f 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2e 20 4e 6f 74 20 6a 75 73 74 20 6e | to.the.documentation..Not.just.n |
| 5ea0 | 65 77 20 61 64 64 69 74 69 6f 6e 73 20 62 75 74 20 61 6c 73 6f 20 63 6f 72 72 65 63 74 69 6f 6e | ew.additions.but.also.correction |
| 5ec0 | 73 20 74 6f 20 65 78 69 73 74 69 6e 67 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2e 00 57 65 20 | s.to.existing.documentation..We. |
| 5ee0 | 65 6e 63 6f 75 72 61 67 65 20 65 76 65 72 79 20 56 79 4f 53 20 75 73 65 72 20 74 6f 20 68 65 6c | encourage.every.VyOS.user.to.hel |
| 5f00 | 70 20 75 73 20 69 6d 70 72 6f 76 65 20 6f 75 72 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 61 | p.us.improve.our.documentation.a |
| 5f20 | 73 20 77 65 20 68 61 76 65 20 61 20 64 65 66 69 63 69 74 20 6c 69 6b 65 20 6d 6f 73 74 20 73 6f | s.we.have.a.deficit.like.most.so |
| 5f40 | 66 74 77 61 72 65 20 70 72 6f 6a 65 63 74 73 2e 20 20 54 68 69 73 20 6e 6f 74 20 6f 6e 6c 79 20 | ftware.projects...This.not.only. |
| 5f60 | 68 65 6c 70 73 20 79 6f 75 20 77 68 65 6e 20 72 65 61 64 69 6e 67 20 62 75 74 20 61 6c 73 6f 20 | helps.you.when.reading.but.also. |
| 5f80 | 65 76 65 72 79 6f 6e 65 20 65 6c 73 65 2e 00 57 65 20 75 73 65 20 74 68 65 20 66 6f 6c 6c 6f 77 | everyone.else..We.use.the.follow |
| 5fa0 | 69 6e 67 20 73 79 6e 74 61 78 20 66 6f 72 20 48 65 61 64 6c 69 6e 65 73 2e 00 57 68 65 6e 20 64 | ing.syntax.for.Headlines..When.d |
| 5fc0 | 6f 63 75 6d 65 6e 74 69 6e 67 20 43 4c 49 20 63 6f 6d 6d 61 6e 64 73 2c 20 75 73 65 20 74 68 65 | ocumenting.CLI.commands,.use.the |
| 5fe0 | 20 60 60 2e 2e 20 63 66 67 63 6d 64 3a 3a 60 60 20 64 69 72 65 63 74 69 76 65 20 66 6f 72 20 61 | .``...cfgcmd::``.directive.for.a |
| 6000 | 6c 6c 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6d 6f 64 65 20 63 6f 6d 6d 61 6e 64 73 2e 20 | ll.configuration.mode.commands.. |
| 6020 | 41 6e 20 65 78 70 6c 61 6e 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 64 65 73 63 72 69 62 65 64 20 | An.explanation.of.the.described. |
| 6040 | 63 6f 6d 6d 61 6e 64 20 73 68 6f 75 6c 64 20 62 65 20 61 64 64 65 64 20 62 65 6c 6f 77 20 74 68 | command.should.be.added.below.th |
| 6060 | 69 73 20 73 74 61 74 65 6d 65 6e 74 2e 20 52 65 70 6c 61 63 65 20 61 6c 6c 20 76 61 72 69 61 62 | is.statement..Replace.all.variab |
| 6080 | 6c 65 20 63 6f 6e 74 65 6e 74 73 20 77 69 74 68 20 3c 76 61 6c 75 65 3e 20 6f 72 20 73 6f 6d 65 | le.contents.with.<value>.or.some |
| 60a0 | 74 68 69 6e 67 20 73 69 6d 69 6c 61 72 2e 00 57 68 65 6e 20 64 6f 63 75 6d 65 6e 74 69 6e 67 20 | thing.similar..When.documenting. |
| 60c0 | 6f 70 65 72 61 74 69 6f 6e 61 6c 20 6c 65 76 65 6c 20 63 6f 6d 6d 61 6e 64 73 2c 20 75 73 65 20 | operational.level.commands,.use. |
| 60e0 | 74 68 65 20 60 60 2e 2e 20 6f 70 63 6d 64 3a 3a 60 60 20 64 69 72 65 63 74 69 76 65 2e 20 41 6e | the.``...opcmd::``.directive..An |
| 6100 | 20 65 78 70 6c 61 6e 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 64 65 73 63 72 69 62 65 64 20 63 6f | .explanation.of.the.described.co |
| 6120 | 6d 6d 61 6e 64 20 73 68 6f 75 6c 64 20 62 65 20 61 64 64 65 64 20 62 65 6c 6f 77 20 74 68 69 73 | mmand.should.be.added.below.this |
| 6140 | 20 73 74 61 74 65 6d 65 6e 74 2e 00 57 68 65 6e 20 69 6e 20 64 6f 75 62 74 2c 20 66 6f 6c 6c 6f | .statement..When.in.doubt,.follo |
| 6160 | 77 20 74 68 65 20 73 74 79 6c 65 20 6f 66 20 65 78 69 73 74 69 6e 67 20 64 6f 63 75 6d 65 6e 74 | w.the.style.of.existing.document |
| 6180 | 61 74 69 6f 6e 2e 00 57 68 65 6e 20 72 65 66 65 72 65 6e 63 69 6e 67 20 74 6f 20 56 79 4f 53 20 | ation..When.referencing.to.VyOS. |
| 61a0 | 50 68 61 62 72 69 63 61 74 6f 72 20 54 61 73 6b 73 2c 20 74 68 65 72 65 20 69 73 20 61 20 63 75 | Phabricator.Tasks,.there.is.a.cu |
| 61c0 | 73 74 6f 6d 20 53 70 68 69 6e 78 20 4d 61 72 6b 75 70 20 63 6f 6d 6d 61 6e 64 20 63 61 6c 6c 65 | stom.Sphinx.Markup.command.calle |
| 61e0 | 64 20 60 60 76 79 74 61 73 6b 60 60 20 74 68 61 74 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 | d.``vytask``.that.automatically. |
| 6200 | 72 65 6e 64 65 72 73 20 74 6f 20 61 20 70 72 6f 70 65 72 20 50 68 61 62 72 69 63 61 74 6f 72 20 | renders.to.a.proper.Phabricator. |
| 6220 | 55 52 4c 2e 20 54 68 69 73 20 69 73 20 68 65 61 76 69 6c 79 20 75 73 65 64 20 69 6e 20 74 68 65 | URL..This.is.heavily.used.in.the |
| 6240 | 20 3a 72 65 66 3a 60 72 65 6c 65 61 73 65 2d 6e 6f 74 65 73 60 20 73 65 63 74 69 6f 6e 2e 00 57 | .:ref:`release-notes`.section..W |
| 6260 | 69 74 68 20 74 68 6f 73 65 20 63 75 73 74 6f 6d 20 63 6f 6d 6d 61 6e 64 73 2c 20 69 74 20 69 73 | ith.those.custom.commands,.it.is |
| 6280 | 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 72 65 6e 64 65 72 20 74 68 65 6d 20 69 6e 20 61 20 6d 6f | .possible.to.render.them.in.a.mo |
| 62a0 | 72 65 20 64 65 73 63 72 69 70 74 69 76 65 20 77 61 79 20 69 6e 20 74 68 65 20 72 65 73 75 6c 74 | re.descriptive.way.in.the.result |
| 62c0 | 69 6e 67 20 48 54 4d 4c 2f 50 44 46 20 6d 61 6e 75 61 6c 2e 00 57 69 74 68 20 74 68 6f 73 65 20 | ing.HTML/PDF.manual..With.those. |
| 62e0 | 63 75 73 74 6f 6d 20 63 6f 6d 6d 61 6e 64 73 2c 20 69 74 20 77 69 6c 6c 20 62 65 20 70 6f 73 73 | custom.commands,.it.will.be.poss |
| 6300 | 69 62 6c 65 20 74 6f 20 72 65 6e 64 65 72 20 74 68 65 6d 20 69 6e 20 61 20 6d 6f 72 65 20 64 65 | ible.to.render.them.in.a.more.de |
| 6320 | 73 63 72 69 70 74 69 76 65 20 77 61 79 20 69 6e 20 74 68 65 20 72 65 73 75 6c 74 69 6e 67 20 48 | scriptive.way.in.the.resulting.H |
| 6340 | 54 4d 4c 2f 50 44 46 20 6d 61 6e 75 61 6c 2e 00 57 72 69 74 65 20 44 6f 63 75 6d 65 6e 74 61 74 | TML/PDF.manual..Write.Documentat |
| 6360 | 69 6f 6e 00 59 6f 75 20 63 61 6e 20 65 69 74 68 65 72 20 69 6e 73 74 61 6c 6c 20 53 70 68 69 6e | ion.You.can.either.install.Sphin |
| 6380 | 78 20 28 61 6e 64 20 54 65 58 20 4c 69 76 65 20 66 6f 72 20 50 44 46 20 6f 75 74 70 75 74 29 20 | x.(and.TeX.Live.for.PDF.output). |
| 63a0 | 61 6e 64 20 62 75 69 6c 64 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 6c 6f 63 61 | and.build.the.documentation.loca |
| 63c0 | 6c 6c 79 2c 20 6f 72 20 75 73 65 20 74 68 65 20 44 6f 63 6b 65 72 66 69 6c 65 5f 20 74 6f 20 62 | lly,.or.use.the.Dockerfile_.to.b |
| 63e0 | 75 69 6c 64 20 69 74 20 69 6e 20 61 20 63 6f 6e 74 61 69 6e 65 72 2e 00 59 6f 75 20 63 61 6e 20 | uild.it.in.a.container..You.can. |
| 6400 | 65 69 74 68 65 72 20 69 6e 73 74 61 6c 6c 20 53 70 68 69 6e 78 20 61 6e 64 20 62 75 69 6c 64 20 | either.install.Sphinx.and.build. |
| 6420 | 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 6c 6f 63 61 6c 6c 79 2c 20 6f 72 20 75 73 | the.documentation.locally,.or.us |
| 6440 | 65 20 74 68 65 20 44 6f 63 6b 65 72 66 69 6c 65 5f 20 74 6f 20 62 75 69 6c 64 20 69 74 20 69 6e | e.the.Dockerfile_.to.build.it.in |
| 6460 | 20 61 20 63 6f 6e 74 61 69 6e 65 72 2e 00 59 6f 75 72 20 72 65 6d 6f 74 65 20 72 65 70 6f 20 6f | .a.container..Your.remote.repo.o |
| 6480 | 6e 20 47 69 74 68 75 62 20 69 73 20 63 61 6c 6c 65 64 20 60 60 6f 72 69 67 69 6e 60 60 2c 20 77 | n.Github.is.called.``origin``,.w |
| 64a0 | 68 69 6c 65 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 72 65 70 6f 20 79 6f 75 20 68 61 76 65 20 | hile.the.original.repo.you.have. |
| 64c0 | 66 6f 72 6b 65 64 20 69 73 20 63 61 6c 6c 65 64 20 60 60 75 70 73 74 72 65 61 6d 60 60 2e 20 4e | forked.is.called.``upstream``..N |
| 64e0 | 6f 77 20 79 6f 75 20 63 61 6e 20 6c 6f 63 61 6c 6c 79 20 75 70 64 61 74 65 20 79 6f 75 72 20 66 | ow.you.can.locally.update.your.f |
| 6500 | 6f 72 6b 65 64 20 72 65 70 6f 2e 00 60 60 31 39 32 2e 30 2e 32 2e 30 2f 32 34 60 60 00 60 60 31 | orked.repo..``192.0.2.0/24``.``1 |
| 6520 | 39 38 2e 35 31 2e 31 30 30 2e 30 2f 32 34 60 60 00 60 60 32 30 30 31 3a 64 62 38 3a 3a 2f 33 32 | 98.51.100.0/24``.``2001:db8::/32 |
| 6540 | 60 60 00 60 60 32 30 33 2e 30 2e 31 31 33 2e 30 2f 32 34 60 60 00 60 60 3a 72 65 66 3a 60 43 68 | ``.``203.0.113.0/24``.``:ref:`Ch |
| 6560 | 65 63 6b 20 6f 75 74 20 56 4c 41 4e 3c 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2f 69 6e 74 65 72 | eck.out.VLAN<configuration/inter |
| 6580 | 66 61 63 65 73 2f 65 74 68 65 72 6e 65 74 3a 76 6c 61 6e 3e 60 60 00 60 60 3a 72 65 66 3a 60 63 | faces/ethernet:vlan>``.``:ref:`c |
| 65a0 | 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2f 69 6e 74 65 72 66 61 63 65 73 2f 65 74 68 65 72 6e 65 74 | onfiguration/interfaces/ethernet |
| 65c0 | 3a 76 6c 61 6e 60 60 00 60 60 73 65 74 20 66 69 72 65 77 61 6c 6c 20 7a 6f 6e 65 60 60 20 69 73 | :vlan``.``set.firewall.zone``.is |
| 65e0 | 20 77 72 69 74 74 65 6e 20 69 6e 20 60 60 66 69 72 65 77 61 6c 6c 2f 7a 6f 6e 65 2e 72 73 74 60 | .written.in.``firewall/zone.rst` |
| 6600 | 60 00 60 60 73 65 74 20 69 6e 74 65 72 66 61 63 65 73 20 65 74 68 65 72 6e 65 74 60 60 20 69 73 | `.``set.interfaces.ethernet``.is |
| 6620 | 20 77 72 69 74 74 65 6e 20 69 6e 20 60 60 69 6e 74 65 72 66 61 63 65 73 2f 65 74 68 65 72 6e 65 | .written.in.``interfaces/etherne |
| 6640 | 74 2e 72 73 74 60 60 00 61 20 73 69 6d 70 6c 65 20 65 78 70 6c 61 6e 61 74 69 6f 6e 20 6f 66 20 | t.rst``.a.simple.explanation.of. |
| 6660 | 77 68 61 74 20 69 73 20 74 68 69 73 20 70 61 67 65 20 61 62 6f 75 74 2c 20 77 68 79 20 6f 72 20 | what.is.this.page.about,.why.or. |
| 6680 | 77 68 65 6e 20 69 74 20 69 73 20 72 65 71 75 69 72 65 64 20 74 6f 20 62 65 20 75 73 65 64 00 63 | when.it.is.required.to.be.used.c |
| 66a0 | 66 67 63 6d 64 00 63 6d 64 69 6e 63 6c 75 64 65 00 68 61 6e 64 6c 65 20 62 75 69 6c 64 20 65 72 | fgcmd.cmdinclude.handle.build.er |
| 66c0 | 72 6f 72 73 00 68 6f 77 20 74 6f 20 63 6f 6c 6c 65 63 74 20 6c 6f 67 73 20 6f 72 20 6f 74 68 65 | rors.how.to.collect.logs.or.othe |
| 66e0 | 72 20 64 65 62 75 67 67 69 6e 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 28 6c 69 6b 65 20 60 73 | r.debugging.information.(like.`s |
| 6700 | 68 6f 77 60 20 63 6f 6d 6d 61 6e 64 73 20 6f 75 74 70 75 74 29 00 68 6f 77 20 74 6f 20 72 65 61 | how`.commands.output).how.to.rea |
| 6720 | 64 20 61 6e 64 20 77 68 61 74 20 74 6f 20 73 65 61 72 63 68 20 66 6f 72 20 69 6e 20 6c 6f 67 73 | d.and.what.to.search.for.in.logs |
| 6740 | 20 61 6e 64 20 63 6f 6c 6c 65 63 74 65 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 00 6b 6e 6f 77 6e | .and.collected.information.known |
| 6760 | 20 69 73 73 75 65 73 20 6f 72 20 70 6f 74 65 6e 74 69 61 6c 20 70 72 6f 62 6c 65 6d 73 20 66 6f | .issues.or.potential.problems.fo |
| 6780 | 72 20 74 68 65 20 73 65 72 76 69 63 65 20 6f 72 20 75 73 65 20 63 61 73 65 00 6f 70 63 6d 64 00 | r.the.service.or.use.case.opcmd. |
| 67a0 | 72 65 66 65 72 65 6e 63 65 73 20 74 6f 20 73 74 61 6e 64 61 72 64 73 2c 20 52 46 43 73 00 74 68 | references.to.standards,.RFCs.th |
| 67c0 | 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 69 6e 74 65 72 66 61 63 65 2d 61 64 64 72 65 73 73 2e 74 | e.content.of.interface-address.t |
| 67e0 | 78 74 20 6c 6f 6f 6b 73 20 6c 69 6b 65 20 74 68 69 73 00 74 6f 20 75 73 65 20 61 6e 20 61 6c 74 | xt.looks.like.this.to.use.an.alt |
| 6800 | 65 72 6e 61 74 69 76 65 20 68 79 70 65 72 6c 69 6e 6b 20 75 73 65 20 69 74 20 74 68 69 73 20 77 | ernative.hyperlink.use.it.this.w |
| 6820 | 61 79 3a 00 76 79 74 61 73 6b 00 77 68 61 74 20 61 72 65 20 69 6e 64 69 63 61 74 6f 72 73 20 6f | ay:.vytask.what.are.indicators.o |
| 6840 | 66 20 67 6f 6f 64 20 61 6e 64 20 62 61 64 20 73 74 61 74 65 73 20 69 6e 20 64 65 62 75 67 67 69 | f.good.and.bad.states.in.debuggi |
| 6860 | 6e 67 20 6f 75 74 70 75 74 73 00 77 6f 72 6b 61 72 6f 75 6e 64 73 20 66 6f 72 20 6b 6e 6f 77 6e | ng.outputs.workarounds.for.known |
| 6880 | 20 69 73 73 75 65 73 20 28 69 66 20 61 6e 79 20 65 78 69 73 74 29 00 | .issues.(if.any.exist). |
 |
index : vyos-documentation.git | |
| VyOS readthedocs (mirror of https://github.com/vyos/vyos-documentation.git) |
| summaryrefslogtreecommitdiff |
blob: 267b3f0a7c240be0e4a6ec680b5fa78774b51dbf (plain)