From 03946ffd6b861922b7abe6834e56ba45385eb3af Mon Sep 17 00:00:00 2001
From: David Karlsson <david.karlsson@docker.com>
Date: Wed, 12 Oct 2022 16:33:42 +0200
Subject: [PATCH] Add page about repo logos

---
 .github/vale/Docker/Acronyms.yml             |   2 +-
 .github/vale/Vocab/Technology/accept.txt     |   3 ++
 _data/toc.yaml                               |   2 ++
 docker-hub/publish/images/clear_logo_sm.png  | Bin 0 -> 1573 bytes
 docker-hub/publish/images/upload_logo_sm.png | Bin 0 -> 1655 bytes
 docker-hub/publish/repository-logos.md       |  35 +++++++++++++++++++
 6 files changed, 41 insertions(+), 1 deletion(-)
 create mode 100644 docker-hub/publish/images/clear_logo_sm.png
 create mode 100644 docker-hub/publish/images/upload_logo_sm.png
 create mode 100644 docker-hub/publish/repository-logos.md

diff --git a/.github/vale/Docker/Acronyms.yml b/.github/vale/Docker/Acronyms.yml
index 85f7136c2e..5dd53743ac 100644
--- a/.github/vale/Docker/Acronyms.yml
+++ b/.github/vale/Docker/Acronyms.yml
@@ -5,7 +5,7 @@ level: warning
 ignorecase: false
 # Ensures that the existence of 'first' implies the existence of 'second'.
 first: '\b([A-Z]{3,5})\b'
-second: '(?:\b[A-Z][a-z]+ )+\(([A-Z]{3,5})\)'
+second: '(?:\b[A-Z][a-z]+(?: |\n))+\(([A-Z]{3,5})\)'
 # ... with the exception of these:
 exceptions:
   - API
diff --git a/.github/vale/Vocab/Technology/accept.txt b/.github/vale/Vocab/Technology/accept.txt
index b97433f09e..082df9686e 100644
--- a/.github/vale/Vocab/Technology/accept.txt
+++ b/.github/vale/Vocab/Technology/accept.txt
@@ -9,8 +9,10 @@ HTTP
 IPs?
 IPv[46]
 IPvlan
+JPEG
 MAC
 RPM
+PNG
 SDKs?
 SSO
 TCP
@@ -28,6 +30,7 @@ deserialization
 deserialize
 filepath
 firewalld
+filetype
 glibc
 goroutine
 hostname
diff --git a/_data/toc.yaml b/_data/toc.yaml
index c27f8537c9..89da03c6b9 100644
--- a/_data/toc.yaml
+++ b/_data/toc.yaml
@@ -1785,6 +1785,8 @@ manuals:
         title: Overview
       - path: /docker-hub/publish/insights-analytics/
         title: Insights and analytics
+      - path: /docker-hub/publish/repository-logos/
+        title: Repository logos
       - path: /docker-hub/publish/publisher-center-migration/
         title: Migrate content from the Publisher Center
   - path: /docker-hub/release-notes/
diff --git a/docker-hub/publish/images/clear_logo_sm.png b/docker-hub/publish/images/clear_logo_sm.png
new file mode 100644
index 0000000000000000000000000000000000000000..fcb53b7308967ed01f5eea6829994358f18c90ca
GIT binary patch
literal 1573
zcmZ`(4OCKR82&JwmbpkxOG`M*#Az91S|OT-sLcEW%b%L%^m3#`P^i?>RWmJ3Gu_hp
zzcV+ZRw+!f(teg^t+dUwCfZJ=4)Y%b6#?1DsaacR_nh~>@AtmX^FH7G?tSm6;6PuK
zMOKRd047vFZyNMA&{i2OfcNawwI0x6WBh0V0HoRha5MveS(rLH2*3e607H8LAQl5)
z$tk-YLV|_5;O(IltyZhiXl7?s)6>eSsTqZ0TBTCUWb%oL$?<X7)YP<Et(lxuNTqVM
zT0J*6CznrYG;=dEN|{WdRL+i!jCXhU3=NGA506PCL)Fzkh(uRMM<*H^Z&p@T_4of(
zT3RL&H4F|8H#OZXF8;Q&^Ql<eTV7sKT3XuG^=xcRT307HcI+6Rf3dN#sidT|xw)mj
z{_2ezO=9u$va+)JdXYdNtgRLF_e-SGNu^T7*}8T++&t<Fe_wBK(qNSzTrA}HMQ{PI
zSfeu(m1a8ulZHHM0L4&(!WiIC5t&z1kQ0#_8qT9dAHs5y*bHVog5{-f5NtAw1AzV6
z6LkNBcd?6mht1vf&ShkrA)AcMMisfI`)=mb-I#3;gW^1_jMCDMbnGHs@DZe(9cn4T
z?LYT9>!tZEmT=7Ua7QtVP#+y1F%+eJZS$yXu*ys7j=dK5@Kj;8iD7=>@<Y_gmJa%W
zxv|CaemfVT1HW88-8K=tyRINK?&HcOhkVVZKYdAxJ?mnzq`>yHUSHFw?Tq;zFXNu5
zh7+Fgn5gzVbcmg$nfcQ#;%sx`%0I30jmg&346?p7XD~74yBK@#Fi%D7Pp|oy#6CBf
zFtgm+&Sw|nWZyoG$L%woZ429TkRI8Eml%n~CxnF&MR~77MPF&ze%Q+ea+;8|`e?O#
zQFU1Um#vQm+uDgw1U_b$J0{apl|EsdNJ(PQZ*ECN)#TjPzNUt#oL09q`Mpa!3j_J>
zvH`6He)gkFfn9nHEs+WEkS(d+UZM7nbLmX_T`bx_&!8ax`+$9&sq)&oeZy&;TJ7D8
z*an(dn)b(vWZ_89b3^bEno|72$P0bjh<<O`@?2lC>8pz2JASWfe(W`*I62Osf03;i
z$U;YYMopkQ1U0Rs)8}IzK3E#bTi_|e;2c7;^A!Aw3c@n$v=IB~>&U_M#O~VeE=6v8
z4Q=Jm?m=ux&cIN+MWN6?ew`?xN0rNMCzWg^d9e0Z9<-?(t=J=emU-=rHM22&7pqy-
zS`!kuqp#UsTX3LzR^?lB@t!AQbEW(|eyj{F4%^h(-~SosR^0{@fmw3zS{lFJSd0;T
z6XUw^Yus+fUw=1!e4pZqPt7~Ivvz&3%?wUv)?%BNZZ^SIqwo$ZvyN*#65*$L4hg3+
z0s?>ojE#Uk$_g032nEdpWj!DJpzMKev{670fGj4^e~Sr(UU%g~({bK-{enzj2v?@i
zGOAE-nXq1^H_zNwwO~H>ggD?uCsV1=(_@klB!L^p=DEu$i(z67j}p#{jpiXlSb+{~
zz;AF~hbOFaCWPW$h|U{{F3yg4JQ0r{7QcXR{XGJU9m`~-{6C>2E4%{|?B^ADOcuiB
zMZ+olkH{7xp72IQVm7K9>7_ajlFVcf$?SM`5}gwrg8;&kQa#->n9dg|5D~;+a1kEZ
zwE02jVH~Vl&R2t($w+*-Hxy0aGT8~h)m0`6^ZyVM@g8L39jEbE5VCr{%MLD*L}s&K
z6W*IsbaHZfcZ!bpOLSYZ(81yFh4`T+Zhg(34-o&7G{1_Of(WaBdc3drPU*=D!4Zf8
NR7#-t<!yV9{|$FSh*<yt

literal 0
HcmV?d00001

diff --git a/docker-hub/publish/images/upload_logo_sm.png b/docker-hub/publish/images/upload_logo_sm.png
new file mode 100644
index 0000000000000000000000000000000000000000..074c7c542d4e1cd7b1c7af12b68b2ade4877c42e
GIT binary patch
literal 1655
zcmZ`(2~d+q6y8KEmnce#Oi;nfr4%MyRRUO%a74KiF{yx1NQNjONFor_fE>Z#!DR_5
za)=j>wj&uv!3&BM1A;;#PQ_9Y6bOPz2m}a(Zbpk*r~k~`_x8Q-+i&;H{>uvv^fk~!
z>j3}^@P4>Z=+|jXX9*majYk$hXCC7h8UR3=6#yC80L;Qv#xMW}F#t%S0Kk?4usX4<
zA;cXP9tZmqy(ec>3kwTswOXZ`o1UJTnwp-RRL;-OE0r^H`J_}j@&3JhW@c6{SEy7f
zg<@)URwa`u#>S+boll#Zny03eVsTGf+vEEBhTPoT^z`)J-oE_&{LIYEqeqX<&CSbX
z6C%;GoE+}Oi<eqkg(6W8m&;90=aiRMba#s{U%t}SB`z;7Z)mt95Y%xv9H~@ZTPw)Q
z$~t-Sq)^x{7C-0lco!~Q7#tkBa;1jP=a-h2!l9&uFOiH54M`>@CKU>}VfEbH+&X5F
zD?AtC=bgSd!~)W;4^DIw{m4uJj4d^Wz=v8$VN#og5AfC=LYOVJHoEp>p8#@prx8i4
z(C8HN#3Tll7Edu}u@fogsq{nuYzlJ-JCmEum%SWCc_2%&v-7<S-pxkxJvhEwY6xz$
zj`pCqt!SMiM-F%IalhtM%Py3(oVDIx5<%}rJ)jH5R~_mur90F`$CD+I3nS|umkn2X
z$~?^L<Jx(}c?Q}A#U?5EiI#4{8<f7W$)J^sU{lR`g|b5$9DcKi7`MD)MT)PHa$~=H
zY@v(siXw{>$boxf7SpJ`p8CC!w{y0|n?-h>G7Pa=ZG`G^eUXR4uIWP;=zE#sv%R!r
z$A=HFt72?$ySGioULUD3J22oT7jVy;TKVju9vj#<zqK)cTZeAvaZ0cJTEE$l@plfo
zWd5m<ym;+}zYDg7TaH|!vVEjK6-9cg*E&^ib{q9?M+e;A@kBN9#x$adHiB1a-P@3Y
z$BI+k`;L#+rQQ|!GG6X;896Qaey^H=sAklqJ=4)|w|fg)9E`_#5^bL3i2h8@#2A8L
zgKRsSZ$g~)UUP5Uczu6=$ihO!CVw*S)Ol-af?re-O0OlQF!Z5}WQciEwZ_<zygu5d
z)`Cj5D<qy4Tl<jK2USI##{52L+2~c`7wET=|BHKATch939r?$M406JGoMVz*%~vJP
zZMN&5n~O%N)k2aWy650kG1ABJ1ijAg9NAcKBU!(X-<9PSIPHJOgR0cdy5Er&fi5ZQ
z%yKo^kvl#-z;sv7QpXKR{Ya~o0-<=~a&amCkzjhP{wB#}BIKbU!%a3AU+>uQ%<+sn
z$+Ri5t8SEiZY+6#J&wMOI?N8qsJb)XpNg#rYHj9d8|giDA(e%5)US~<%Nn?I#8yIt
zvTEpn$jL2?H)T5H5E$4#x$8F}ZDU{db-h~(y!YK=pIqNFOiruw_PqD5w{XOpZ&m29
zmWxyBy!qA#f27&+GKcLC!y8>fA>pY30bmo1b$}KE4VJ<P0c|V7bTRfp*Z|FAfdEJV
za%n*8BPI}f&8K-mG@K7!tB4D<;cOMO>`KH(CahN?7n!)qC7)u51D*sgJRW*NOcI5X
zz>H(CWa;JaV8W8+O=87HvnW_tfetug9G&bi4t7osM2rj8$r<b7WQ)OIF__U8uM)l>
z&>68bD*OKlXLCv2kYKZ@z@pJ9Ojb1fdH*Bgigj@PAYu|$tqVCTH5^JRjf(YR#50lz
ziP13>;IQHxQgen?i$!mU2%=J%6c*ULMJPUG4XdjctHHEXN<0Y%MH84bMgsU@%eTwZ
z{J(~fKZiUjtrkMahQ(EOF)2x23_4td^`VRQ_V%B;X#41_W=qBzIDD0`Uu!n<^GIJI
jzK~ptAp8Xp=zrJvT=A2V=vA%eMghEcAnw=gQJMb$T{y6+

literal 0
HcmV?d00001

diff --git a/docker-hub/publish/repository-logos.md b/docker-hub/publish/repository-logos.md
new file mode 100644
index 0000000000..c5f53ed1d3
--- /dev/null
+++ b/docker-hub/publish/repository-logos.md
@@ -0,0 +1,35 @@
+---
+title: Repository logos
+description: Override the organization logo on a per-repository basis
+keywords: dvp, verified, publisher, repository, logo, icons
+---
+
+Docker Verified Publishers (DVP) and Docker Sponsored Open Source (DSOS)
+organizations can upload custom images for individual repositories on Docker Hub.
+This lets you override the default organization-level logo on a per-repository basis.
+
+Only a user with administrative access (owner or team member with Admin permission)
+over the repository can change the repository logo.
+
+## Image requirements
+
+- The supported filetypes for the logo image are JPEG and PNG.
+- The minimum allowed image size in pixels is 120×120
+- The maximum allowed image size in pixels is 1000×1000
+- The maximum allowed image file size is 5MB
+
+## Set the repository logo
+
+1. Sign in to Docker Hub.
+2. Go to the page of the repository that you want to change the logo for.
+3. Select the upload logo button, represented by a camera icon
+   (![Camera icon](./images/upload_logo_sm.png){: .inline height="22px" })
+   overlaying the current repository logo.
+4. In the dialog that opens, select the PNG image that you want to upload.
+5. Select **Open** to upload the image and set it as the logo for the repository.
+
+## Remove the logo
+
+Remove a logo using the clear button (![Clear button](../images/clear_logo_sm.png){: .inline height="22px" }).
+
+Removing the logo makes the repository fallback to using the organization logo, if set.