howto/Getting-Started.md
... ...
@@ -22,7 +22,7 @@ You must create several objects in the DN42 registry: <https://git.dn42.dev/dn42
22 22
23 23
The registry is a git repository, objects are created by creating a branch in the main repository, making your changes and then submitting a pull request for review. There are detailed instructions in the registry [README](https://git.dn42.dev/dn42/registry/src/branch/master/README.md) how to do this. See also the the generic git documentation [git documentation](https://git-scm.com/book/en/v2/Git-Basics-Working-with-Remotes) and guides on [github](https://help.github.com/en/github/using-git) for how to use git to work with remote repositories.
24 24
25
-When submitting your pull request, please squash your commits, again there are instructions in the [README](https://git.dn42.dev/dn42/registry/src/branch/master/README.md) for how to do this.
25
+When submitting your pull request, you must squash multiple changes to a single commit, again there are instructions in the [README](https://git.dn42.dev/dn42/registry/src/branch/master/README.md) for how to do this.
26 26
27 27
Remember to add authentication to your `mntner` object, and [sign your commit](/howto/Registry-Authentication)
28 28
... ...
@@ -31,12 +31,13 @@ The registry includes a number of scripts to help check your request:
31 31
- `fmt-my-stuff <FOO>-MNT`: automatically fixes minor formatting errors
32 32
- `check-my-stuff <FOO>-MNT`: validates your objects against the registry schema
33 33
- `check-pol origin/master <FOO>-MNT`: checks for policy violations
34
+ - `squash-my-commits`: automatically update and squash your local commits
34 35
35
-The registry maintainers run all three scripts against each request, so please run these yourself first to check for simple errors.
36
+The registry maintainers run the checking scripts against each request, so please run these yourself first to check for simple errors.
36 37
37 38
Do browse through the registry and look at the [pull request queue](https://git.dn42.dev/dn42/registry/pulls) to see examples, understand how the process works and see the types of questions asked by the registry maintainers.
38 39
39
-*Whilst it is possible to use the web interface to edit files, you are encouraged to clone your repo locally and use the command line git tools. It's easy to do and learning how to use git is a skill worth knowing. Using the web interface creates a large number of commits and prevents you from checking your changes with the registry scripts*
40
+*You should not use the gitea web interface to edit files, doing so would create a large number of commits and prevents running of the registry scripts*
40 41
41 42
---
42 43
... ...
@@ -83,6 +84,11 @@ Create a `person` object in `data/person/` for **yourself** (not your organisat
83 84
- you may wish to add other fields, such as `pgp-fingerprint`, `remarks`, and so on.
84 85
- don't forget to set `mnt-by` to `<FOO>-MNT`.
85 86
87
+**Data Privacy**
88
+
89
+Contact attributes are optional but DN42 is a dynamic network and being able to contact users is really important if there are changes or problems. However, please also be aware that the DN42 registry is a public resource and you must assume that any details provided will be made public and cannot be fully removed. If this is a concern for you, please do not provide bogus contact details; simply provide anonymous details that are specific for use within DN42 or leave them out entirely.
90
+
91
+
86 92
Example: data/person/FOO-DN42
87 93
```
88 94
person: John Doe
... ...
@@ -116,7 +122,7 @@ mnt-by: FOO-MNT
116 122
source: DN42
117 123
```
118 124
119
-### Guidelines for future objects
125
+### Guidelines for resource objects
120 126
121 127
From now on, you should use:
122 128
... ...
@@ -128,7 +134,7 @@ This applies to AS numbers, network prefixes, routes, DNS records...
128 134
129 135
### Register an AS number
130 136
131
-To register an AS number, simply create an `aut-num` object in `data/aut-num/`.
137
+To register an AS number, create an `aut-num` object in `data/aut-num/`.
132 138
`as-name` should be a name for your AS.
133 139
134 140
Your AS number can be chosen arbitrarily in the dn42 ASN space, see the [as-block objects](https://git.dn42.dev/dn42/registry/src/master/data/as-block) in the registry.
... ...
@@ -137,7 +143,9 @@ Your AS number can be chosen arbitrarily in the dn42 ASN space, see the [as-bloc
137 143
138 144
For a list of currently assigned AS numbers browse the registry data/aut-num/ directory or [online](https://explorer.burble.com/#/aut-num/).
139 145
140
-If you intend to use an ASN outside of the native dn42 ranges, please check that it doesn't clash with the [Freifunk AS-Numbers] (http://wiki.freifunk.net/AS-Nummern) or other networks (ChaosVPN, etc). For a list of ASN currently announced in dn42, see [this map](http://nixnodes.net/dn42/graph/).
146
+If you intend to use an ASN outside of the native dn42 ranges, please check that it doesn't clash with the [Freifunk AS-Numbers] (http://wiki.freifunk.net/AS-Nummern) or other networks (ChaosVPN, etc).
147
+
148
+Internet ASNs may be used, but you must take care to clearly separate Internet and DN42 routes and prevent routes leaking between the networks. For Internet ASNs, the `source` attribute must be the originating registry and you will be required to prove you are the owner of the ASN.
141 149
142 150
If unsure, ask on the mailing list or IRC.
143 151
internal/Internal-Services.md
... ...
@@ -148,6 +148,7 @@ Repository Mirrors are listed on another page: [Repository Mirrors](/services/Re
148 148
| ttd.nia.dn42 (172.20.168.132, fd01:1926:817:2::) | OpenTTD | 1.10.1, Optimized for CN |
149 149
| ttd.jerry.dn42 (172.20.51.99, fd07:d34:7969:2::1) | OpenTTD | 1.10.2, Hosted by jerry, Optimized for CN |
150 150
| stk.jerry.dn42:2759 (172.20.51.99, fd07:d34:7969:2::1) | SuperTuxKart | 1.1, Optimized for CN |
151
+| ns1.deltaman.dn42 (172.22.134.131, fd1b:7f7d:dd55:4600:219:ff:fe00:fafe) | OpenTTD | 1.10.3, Hosted in NL |
151 152
152 153
## Shell
153 154