Rename to 'shields', add some preliminary graphics

parent 68e7b428
Pipeline #56134 passed with stage
in 2 minutes and 37 seconds
---
title: Badges
title: Shields
layout: docs
permalink: /docs/badges/
permalink: /docs/shields/
---
When you have set up reproducible builds for your project, you can announce
this by adding a 'badge' to your project page. We have badges for various
this by adding a 'shield' to your project page. We have shields for various
'levels' of reproducible builds support:
* Plain
* Bronze
* Silver
* Gold
* ![Regular]({{ "/images/shields/shield.svg" | prepend: site.baseurl }})
* ![Bronze]({{ "/images/shields/shield-bronze.svg" | prepend: site.baseurl }})
* ![Silver]({{ "/images/shields/shield-silver.svg" | prepend: site.baseurl }})
* ![Gold]({{ "/images/shields/shield-gold.svg" | prepend: site.baseurl }})
'Plain' is the maximum level you can achieve when you leave it up to
'Regular' is the maximum level you can achieve when you leave it up to
distributors (e.g. Linux distributions) to create packaged artifacts. When you
publish artifacts yourself, the other levels come into play.
'Bronze' is achievable. For the 'Silver' and 'Gold' levels, infrastructure to
share attestations is required. Such infrastructure is still in the prototype
phase.
## Advantages
| |B|S|G| |
| |![Bronze]({{ "/images/shields/bronze-star.svg" | prepend: site.baseurl }})|![Silver]({{ "/images/shields/silver-star.svg" | prepend: site.baseurl }})|![Gold]({{ "/images/shields/gold-star.svg" | prepend: site.baseurl }})| |
|-|-|-|-|-|
|v|v|v|v|everything is set up so distributors can secure their pipeline|
| |v|v|v|artifacts tainted by compromised build infrastructure will be detected|
......@@ -29,7 +32,7 @@ publish artifacts yourself, the other levels come into play.
## Requirements
| |B|S|G| |
| |![Bronze]({{ "/images/shields/bronze-star.svg" | prepend: site.baseurl }})|![Silver]({{ "/images/shields/silver-star.svg" | prepend: site.baseurl }})|![Gold]({{ "/images/shields/gold-star.svg" | prepend: site.baseurl }})| |
|-|-|-|-|-|
|v|v|v|v|you have a [deterministic build system](plans.md#getting-a-deterministic-build-system)|
| |v|v|v|artifacts you publish can be rebuilt and verified|
......@@ -38,6 +41,7 @@ publish artifacts yourself, the other levels come into play.
| | |v|v|infrastructure is in place for end-users to share attestations|
| | | |v|infrastructure is in place for end-users to automatically verify attestations when fetching the artifacts|
When adding a badge, it is recommended that it links to:
* Plain: documentation on how to build your project reproducibly
......
......@@ -43,6 +43,7 @@ main {
td {
border: 1px solid #ddd;
text-align: center;
}
@media (min-width: 750px) {
......
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<svg
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:cc="http://creativecommons.org/ns#"
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:svg="http://www.w3.org/2000/svg"
xmlns="http://www.w3.org/2000/svg"
xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
width="17.841618"
height="16.71648"
version="1.1"
id="svg30"
sodipodi:docname="bronze-star.svg"
inkscape:version="0.92.4 (5da689c313, 2019-01-14)">
<metadata
id="metadata36">
<rdf:RDF>
<cc:Work
rdf:about="">
<dc:format>image/svg+xml</dc:format>
<dc:type
rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
<dc:title></dc:title>
</cc:Work>
</rdf:RDF>
</metadata>
<defs
id="defs34" />
<sodipodi:namedview
pagecolor="#ffffff"
bordercolor="#666666"
borderopacity="1"
objecttolerance="10"
gridtolerance="10"
guidetolerance="10"
inkscape:pageopacity="0"
inkscape:pageshadow="2"
inkscape:window-width="1981"
inkscape:window-height="1574"
id="namedview32"
showgrid="false"
inkscape:zoom="6.4409265"
inkscape:cx="-84.561902"
inkscape:cy="-33.163748"
inkscape:window-x="1217"
inkscape:window-y="0"
inkscape:window-maximized="0"
inkscape:current-layer="svg30"
fit-margin-top="0"
fit-margin-left="0"
fit-margin-right="0"
fit-margin-bottom="0" />
<linearGradient
id="b"
x2="0"
y2="1">
<stop
offset="0"
stop-color="#bbb"
stop-opacity=".1"
id="stop2" />
<stop
offset="1"
stop-opacity=".1"
id="stop4" />
</linearGradient>
<clipPath
id="a">
<rect
width="157"
height="20"
rx="3"
id="rect7"
x="0"
y="0"
style="fill:#ffffff" />
</clipPath>
<style
id="style2234"
type="text/css">
.st0{fill:#1E5B96;}
.st1{fill:#2B89D6;}
</style>
<path
id="path2560"
d="m 8.9208134,0.5266861 2.1034796,5.9599042 h 6.3105 l -4.90816,3.8564057 1.75292,5.959904 -5.2587396,-3.505831 -5.25875,3.505831 1.75292,-5.959904 L 0.50682344,6.4865903 H 6.8173134 Z"
inkscape:connector-curvature="0"
style="fill:#f58f00;fill-opacity:0.82589285;stroke:#000000;stroke-width:0.35058263" />
</svg>
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<svg
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:cc="http://creativecommons.org/ns#"
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:svg="http://www.w3.org/2000/svg"
xmlns="http://www.w3.org/2000/svg"
xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
width="17.841618"
height="16.71648"
version="1.1"
id="svg30"
sodipodi:docname="gold-star.svg"
inkscape:version="0.92.4 (5da689c313, 2019-01-14)">
<metadata
id="metadata36">
<rdf:RDF>
<cc:Work
rdf:about="">
<dc:format>image/svg+xml</dc:format>
<dc:type
rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
<dc:title></dc:title>
</cc:Work>
</rdf:RDF>
</metadata>
<defs
id="defs34" />
<sodipodi:namedview
pagecolor="#ffffff"
bordercolor="#666666"
borderopacity="1"
objecttolerance="10"
gridtolerance="10"
guidetolerance="10"
inkscape:pageopacity="0"
inkscape:pageshadow="2"
inkscape:window-width="1981"
inkscape:window-height="1574"
id="namedview32"
showgrid="false"
inkscape:zoom="6.4409265"
inkscape:cx="-84.561902"
inkscape:cy="-33.163748"
inkscape:window-x="1217"
inkscape:window-y="0"
inkscape:window-maximized="0"
inkscape:current-layer="svg30"
fit-margin-top="0"
fit-margin-left="0"
fit-margin-right="0"
fit-margin-bottom="0" />
<linearGradient
id="b"
x2="0"
y2="1">
<stop
offset="0"
stop-color="#bbb"
stop-opacity=".1"
id="stop2" />
<stop
offset="1"
stop-opacity=".1"
id="stop4" />
</linearGradient>
<clipPath
id="a">
<rect
width="157"
height="20"
rx="3"
id="rect7"
x="0"
y="0"
style="fill:#ffffff" />
</clipPath>
<style
id="style2234"
type="text/css">
.st0{fill:#1E5B96;}
.st1{fill:#2B89D6;}
</style>
<path
id="path2560"
d="m 8.9208134,0.5266861 2.1034796,5.9599042 h 6.3105 l -4.90816,3.8564057 1.75292,5.959904 -5.2587396,-3.505831 -5.25875,3.505831 1.75292,-5.959904 L 0.50682344,6.4865903 H 6.8173134 Z"
inkscape:connector-curvature="0"
style="fill:#f5eb00;fill-opacity:0.82589285;stroke:#000000;stroke-width:0.35058263" />
</svg>
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<svg
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:cc="http://creativecommons.org/ns#"
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:svg="http://www.w3.org/2000/svg"
xmlns="http://www.w3.org/2000/svg"
xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
width="17.841618"
height="16.71648"
version="1.1"
id="svg30"
sodipodi:docname="silver-star.svg"
inkscape:version="0.92.4 (5da689c313, 2019-01-14)">
<metadata
id="metadata36">
<rdf:RDF>
<cc:Work
rdf:about="">
<dc:format>image/svg+xml</dc:format>
<dc:type
rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
<dc:title></dc:title>
</cc:Work>
</rdf:RDF>
</metadata>
<defs
id="defs34" />
<sodipodi:namedview
pagecolor="#ffffff"
bordercolor="#666666"
borderopacity="1"
objecttolerance="10"
gridtolerance="10"
guidetolerance="10"
inkscape:pageopacity="0"
inkscape:pageshadow="2"
inkscape:window-width="1981"
inkscape:window-height="1574"
id="namedview32"
showgrid="false"
inkscape:zoom="6.4409265"
inkscape:cx="-56.382727"
inkscape:cy="-33.163748"
inkscape:window-x="1217"
inkscape:window-y="0"
inkscape:window-maximized="0"
inkscape:current-layer="svg30"
fit-margin-top="0"
fit-margin-left="0"
fit-margin-right="0"
fit-margin-bottom="0" />
<linearGradient
id="b"
x2="0"
y2="1">
<stop
offset="0"
stop-color="#bbb"
stop-opacity=".1"
id="stop2" />
<stop
offset="1"
stop-opacity=".1"
id="stop4" />
</linearGradient>
<clipPath
id="a">
<rect
width="157"
height="20"
rx="3"
id="rect7"
x="0"
y="0"
style="fill:#ffffff" />
</clipPath>
<style
id="style2234"
type="text/css">
.st0{fill:#1E5B96;}
.st1{fill:#2B89D6;}
</style>
<path
id="path2560"
d="m 8.9208134,0.5266861 2.1034796,5.9599042 h 6.3105 l -4.90816,3.8564057 1.75292,5.959904 -5.2587396,-3.505831 -5.25875,3.505831 1.75292,-5.959904 L 0.50682344,6.4865903 H 6.8173134 Z"
inkscape:connector-curvature="0"
style="fill:#e8e4eb;fill-opacity:0.82589285;stroke:#000000;stroke-width:0.35058263" />
</svg>
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment