Details
Diff Detail
- Repository
- rG FreeBSD src repository
- Lint
Lint Not Applicable - Unit
Tests Not Applicable
Event Timeline
| share/man/man7/development.7 | ||
|---|---|---|
| 64 | do we want to list the public-facing git infra first here, and then mention ssh://git@ for developers? | |
| share/man/man7/development.7 | ||
|---|---|---|
| 64 | IMO just replace this with anongit@git.f.o and punt the internal repo details entirely to the committer's guide. | |
I was only going to remark on the gitrepo thing, but that's already had multiple layers of paint, so I shan't belabor the point.
Looks good to me once that's been addressed.
| share/man/man7/development.7 | ||
|---|---|---|
| 64 | My way of thinking is: most users will just use GitHub mirrors, like they already do. Committers need the read-write repo URL. I believe the public, read-only, project-hosted repo is useful to much smaller group of people, and can be left to the other docs; development(7) is supposed to be as concise as possible. | |
| share/man/man7/development.7 | ||
|---|---|---|
| 64 | What will end up being the official documentation, once it lands, states that gitrepo is only to be used as the push URL, whereas git.f.o is used as the fetch URL. If I recall correctly, the idea is that commiters (and everyone else) in Europe, Asia, and elsewhere shouldn't have to fetch over extremely long links as git.f.o is on a CDN, but we can still get data from a project-controlled source of truth, rather than through GitHub. It's not unlike how svn.f.o was accessed by everyone, and repo.f.o was where things got commited to, as noted by the old commiter's guide. | |
| share/man/man7/development.7 | ||
|---|---|---|
| 64 |
My way of thinking: development(7) should be self-sufficient and independent of any third-party service that is not part of the Project's own infrastructure and controlled directly by us, such as GitHub. Those users who prefer GitHub for some reason should ideally be reading its documentation, not ours. On the other hand, I guess it makes sense to mention it as it is a popular community marketplace which most users are probably familiar with. | |
| share/man/man7/development.7 | ||
|---|---|---|
| 64 | Okay, I see your (plural) point. Should be fixed now :-) | |
Looks good to me now, let's get this landed.
(Remember to bump .Dd before you commit)