Skip to content

Commit 4c5cb1e

Browse files
noerwwxiaoguang
andauthored
Improve package registry docs (#19273)
* Improve package registry docs * move new content down * add hint re upload a package * wording, formatting Co-authored-by: wxiaoguang <[email protected]>
1 parent 58c9d12 commit 4c5cb1e

File tree

1 file changed

+23
-0
lines changed

1 file changed

+23
-0
lines changed

docs/content/doc/packages/overview.en-us.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,29 @@ The following package managers are currently supported:
3838

3939
**The following paragraphs only apply if Packages are not globally disabled!**
4040

41+
## Repository-Packages
42+
43+
A package always belongs to an owner (a user or organisation), not a repository.
44+
To link an (already uploaded) package to a repository, open the settings page
45+
on that package and choose a repository to link this package to.
46+
The entire package will be linked, not just a single version.
47+
48+
Linking a package results in showing that package in the repository's package list,
49+
and shows a link to the repository on the package site (as well as a link to the repository issues).
50+
51+
## Access Restrictions
52+
53+
| Package owner type | User | Organization |
54+
|--------------------|------|--------------|
55+
| **read** access | public, if user is public too; otherwise for this user only | public, if org is public, otherwise org members only |
56+
| **write** access | owner only | org members with admin or write access to the org |
57+
58+
N.B.: These access restrictions are [subject to change](https://github.com/go-gitea/gitea/issues/19270), where more finegrained control will be added via a dedicated organization team permission.
59+
60+
## Create or upload a package
61+
62+
Depending on the type of package, use the respective package-manager for that. Check out the sub-page of a specific package manager for instructions.
63+
4164
## View packages
4265

4366
You can view the packages of a repository on the repository page.

0 commit comments

Comments
 (0)