Differences between revisions 85 and 105 (spanning 20 versions)
Revision 85 as of 2017-01-01 10:41:23
Size: 7385
Editor: PaulWise
Comment: research publications link
Revision 105 as of 2020-11-26 23:40:41
Size: 9870
Editor: PaulWise
Comment: add a potential future improvement to reduce the busywork of updating sources.list snippets
Deletions are marked like this. Additions are marked like this.
Line 9: Line 9:
{{http://www.debian.org/logos/openlogo-nd-25.jpg|example logo}} example is a Debian derivative aimed at being an example derivative. {{https://www.debian.org/logos/openlogo-nd-25.jpg|example logo}} example is a Debian derivative aimed at being an example derivative.
Line 12: Line 12:
 * Homepage: http://www.example.org/
 * Blog: http://blog.example.org/
 * Microblog: http://identi.ca/example
 * Corporate sponsor: [[http://www.example.com/|Example Ltd]]
 * Government sponsor: [[http://www.example.gov.eg/|Example province, example country]]
 * Homepage: https://www.example.org/
 * Origin story: https://www.example.org/about/ /* a page that explains the origin of the distro, how it came to be etc *
/
 * Blog: https://blog.example.org/
 * Microblog: https://identi.ca/example
 * Corporate sponsor: [[https://www.example.com/|Example Ltd]]
 * Government sponsor: [[https://www.example.gov.eg/|Example province, example country]]
Line 18: Line 19:
 * Merchandise: https://www.example.org/merch/ /* a page listing the available merchandise (stickers, t-shirts etc) for fans of the project */
Line 19: Line 21:
 * Research publications: http://wiki.example.org/research/ /* links to academic research publications about your distro */
 * hardware wishlist: http://www.example.org/hardware-wishlist/
 * hardware supported: http://www.example.org/supported-hardware/ /* for specialised distros with specific or limited hardware support */
 * user IRC: irc://irc.oftc.net/example
 * devel IRC: irc://irc.oftc.net/example-devel
 * Debian IRC: irc://irc.oftc.net/debian-example
 * user list: http://lists.example.org/example-user/
 * devel list: http://lists.example.org/example-devel/
 * Debian list: http://lists.example.org/example-debian/
 * user forums: http://forums.example.org/user/
 * devel forum: http://forums.example.org/devel/
 * Debian forum: http://forums.example.org/debian/
 * wiki: http://wiki.example.org/
 * Security contact: security@example.org | http://www.example.org/security/
 * Debian derivatives census maintainer: John Doe <john@example.org> (john on IRC) /* As maintainer you are expected to subscribe to Derivatives/CensusTemplate and Derivatives/Census/Example */
 * Privacy policy: https://www.example.org/privacy/ /* a page listing the privacy policy of the project */
 * Data collection: none | Debian popcon | Example popcon (enabled by default | consent) | [[https://github.com/example/phone-home/|Anonymous stats codebase]] (enabled by default | consent) | [[https://github.com/example/telemetry/|Detailed telemetry codebase]] (enabled by default | consent)
 * Join: https://www.example.org/join/ | https://www.example.com/jobs/ /* links to the community page about how to join the project, or the hiring page for the company running the project, or both */
* Research publications: https://wiki.example.org/research/ /* links to academic research publications about your distro */
 * hardware wishlist: https://www.example.org/hardware-wishlist/ /* for distros who invite donations of specific hardware */
 * hardware supported: https://www.example.org/supported-hardware/ /* for specialised distros with specific or limited hardware support */
 * hardware certification: https://www.example.org/certified-hardware/ /* for distros with a hardware certification program
*/
 * user IRC: ircs://irc.oftc.net/example
 * devel IRC: ircs://irc.oftc.net/example-devel
 * Debian IRC: ircs://irc.oftc.net/debian-example /* for communication between the derivative and Debian, such as a #debian-derivative channel */
 * user list: https://lists.example.org/example-user/
 * devel list: https://lists.example.org/example-devel/
 * Debian list: https://lists.example.org/example-debian/ /* for communication between the derivative and Debian via mailing list */
 * user forums: https://forums.example.org/user/
 * devel forum: https://forums.example.org/devel/
 * Debian forum: https://forums.example.org/debian/ /* for communication between the derivative and Debian */
 * wiki: https://wiki.example.org/
 * Security contact: security@example.org | https://www.example.org/security/
 * Debian derivatives census maintainer: Some One <someone@example.org> (someone on IRC) /* As maintainer you are expected to subscribe to Derivatives/CensusTemplate and Derivatives/Census/Example */
Line 36: Line 42:
 * Debian page: http://www.debian.org/misc/children-distros#example
 * Distrowatch page: http
://distrowatch.com/example /* For the distrowatch page, list either the table.php page, or the top-level redirect. If using a top-level redirect that redirects to a different name, please use the name redirected to */
 * Subscribers: someone@example.org someoneelse@example.org /* Emails to receive notifications about new issues detected for the derivative */
* Distrowatch page: https://distrowatch.com/example /* For the distrowatch page, list either the table.php page, or the top-level redirect. If using a top-level redirect that redirects to a different name, please use the name redirected to */
 * Wikipedia page: https://en.wikipedia.org/wiki/Example
Line 44: Line 51:
 * Archive tool: dak mini-dak reprepro mini-dinstall debarchiver debpool DebMarshal apt-ftparchive dpkg-scanpackages/dpkg-scansources aptly [[http://wiki.example.org/archive-setup|custom setup]]
 * Build status: http://buildd.example.org/
 * Archive tool: dak mini-dak reprepro mini-dinstall debarchiver debpool DebMarshal apt-ftparchive dpkg-scanpackages/dpkg-scansources aptly [[https://wiki.example.org/archive-setup|custom setup]]
 * Build status: https://buildd.example.org/
Line 48: Line 55:
 * Image tool: debian-cd live-build vmdebootstrap [[http://wiki.example.org/image-setup|custom setup]]
 * VCS repository: http://git.example.org/
 * Bug tracker: http://bugs.example.org
 * Bugs forwarded to Debian: [[http://bugs.debian.org/cgi-bin/pkgreport.cgi?users=example-devel@lists.example.org|user example-devel@lists.example.org]] ([[http://udd.debian.org/cgi-bin/example_usertag.cgi|statistics]])
 * Package tracker: http://tracker.example.org /* setup of Distro Tracker: https://tracker.debian.org/docs/ */
 * Image tool: debian-cd live-build vmdebootstrap [[https://wiki.example.org/image-setup|custom setup]]
 * Install tool: debian-installer ubiquity calamares propellor debootstrap dd
 *
VCS repository: https://git.example.org/
 * Bug tracker: https://bugs.example.org
 * Bugs forwarded to Debian: [[https://bugs.debian.org/cgi-bin/pkgreport.cgi?users=example-devel@lists.example.org|user example-devel@lists.example.org]] ([[https://udd.debian.org/cgi-bin/example_usertag.cgi|statistics]])
 * Package tracker: https://tracker.example.org /* setup of Distro Tracker: https://tracker.debian.org/docs/ */
Line 55: Line 63:
 * Patches repo: http://patches.example.org/
 * Docs about Example for Debian developers: http://wiki.example.org/ExampleForDebianDevs
 * Docs about Debian for Example developers: http://wiki.example.org/DebianForExampleDevs
 * Patches repo: https://patches.example.org/
 * Docs about Example for Debian developers: https://wiki.example.org/ExampleForDebianDevs
 * Docs about Debian for Example developers: https://wiki.example.org/DebianForExampleDevs
Line 59: Line 67:
 * Package comparison: http://qa.example.org/packages-and-versions.html
 * Popcon information: http://popcon.example.org/
 * Quality assurance information: http://qa.example.org/
 * lintian information: http://lintian.example.org/
 * piuparts information: http://piuparts
.example.org/
 * static analysis information: http://daca.example.org/
 * list of developers: http://people.example.org/
 * developer blogs: http://planet.example.org/
 * developer microblogs: http://identi.ca/example
 * derivatives info: http://www.example.org/about/derivatives
 * mirrors file: http://ftp.example.org/example/README.mirrors.txt
 * Package comparison: https://qa.example.org/packages-and-versions.html
 * Popcon information: https://popcon.example.org/
 * Quality assurance information: https://qa.example.org/
 * lintian information: https://lintian.example.org/
 * piuparts information: https://piuparts.example.org/
 * CI/autopkgtest information: https://ci
.example.org/
 * static analysis information: https://daca.example.org/
 * list of developers: https://people.example.org/
 * developer blogs: https://planet.example.org/
 * developer microblogs: https://identi.ca/example
 * derivatives of this distribution: https://www.example.org/about/derivatives
 * mirrors list: https://ftp.example.org/example/README.mirrors.txt
 * mirror CDNs: https://cdn.ftp.example.org/ (Fastly, Cloudfront, Cloudflare, Akamai, MirrorBrain, custom)
Line 71: Line 81:
 * changelogs pool: http://www.example.org/changelogs
 * apt repositories (source, binary, stablerelease/nextrelease):
 * changelogs pool: https://www.example.org/changelogs
 * apt repositories: https://ftp.example.org/example/ https://security.example.org/example-security/ https://ports.example.org/example-ports/
 * apt sources list
(source, binary, stablerelease/nextrelease):
Line 74: Line 85:
# In the future (not yet!) you will be able to drop this sources.list snippet if any of these conditions are satisfied:
# 1) you use reprepro in the URLs above and their conf/distributions files are public
# 2) if you provide an ls-lR.gz file at the root of each repository that lists the contents of dists/ and indicate which dirs are symlinks
# 3) if your server directory index for the dists/ dir of each repository is publicly available and indicates which entries are dirs rather than files/symlinks
Line 79: Line 95:
# Please also leave or comment out mirrors of these or other apt repositories.
Line 95: Line 112:
#deb [arch=i386,amd64] ftp://ftp.example.org/example/ nextrelease main contrib non-free
#deb [arch=i386,amd64] ftp://other.example.org/example/ nextrelease main contrib non-free
#deb-src ftp://ftp.example.org/example/ nextrelease main contrib non-free
#deb-src ftp://other.example.org/example/ nextrelease main contrib non-free
#deb [arch=i386,amd64] https://ftp.example.org/example/ nextrelease main contrib non-free
#deb [arch=i386,amd64] https://other.example.org/example/ nextrelease main contrib non-free
#deb-src https://ftp.example.org/example/ nextrelease main contrib non-free
#deb-src https://other.example.org/example/ nextrelease main contrib non-free
Line 100: Line 117:
#deb [arch=i386,amd64] ftp://ftp.example.org/example/ stablerelease main contrib non-free
#deb [arch=i386,amd64] ftp://security.example.org/example/ stablerelease main contrib non-free
#deb [arch=i386,amd64] ftp://backports.example.org/example/ stablerelease main contrib non-free
#deb-src ftp://ftp.example.org/example/ stablerelease main contrib non-free
#deb-src ftp://security.example.org/example/ stablerelease main contrib non-free
#deb-src ftp://backports.example.org/example/ stablerelease main contrib non-free
#deb [arch=i386,amd64] https://ftp.example.org/example/ stablerelease main contrib non-free
#deb [arch=i386,amd64] https://security.example.org/example/ stablerelease main contrib non-free
#deb [arch=i386,amd64] https://backports.example.org/example/ stablerelease main contrib non-free
#deb-src https://ftp.example.org/example/ stablerelease main contrib non-free
#deb-src https://security.example.org/example/ stablerelease main contrib non-free
#deb-src https://backports.example.org/example/ stablerelease main contrib non-free

example

example logo example is a Debian derivative aimed at being an example derivative.

# In the future (not yet!) you will be able to drop this sources.list snippet if any of these conditions are satisfied:
# 1) you use reprepro in the URLs above and their conf/distributions files are public
# 2) if you provide an ls-lR.gz file at the root of each repository that lists the contents of dists/ and indicate which dirs are symlinks
# 3) if your server directory index for the dists/ dir of each repository is publicly available and indicates which entries are dirs rather than files/symlinks

# If you do not provide any apt repository, please list here in comments
# your distribution methods and download URLs for binaries and source.

# If you use Debian, Ubuntu or deb-multimedia.org or other common external repositories,
# please leave them out of your listed sources.list or add them commented out.
# Please also leave or comment out mirrors of these or other apt repositories.

# Please list all of your supported suites, including development ones.

# Please include correct architecture information (the [arch=...] parts)

# Please list your in-development/future release first, then your stable release
# then your oldstable release and so on. Please do not list unsupported releases

# Please uncomment the mirror lines below after modifying them to point at
# the apt repositories for your derivative.

# Please use suite aliases here instead of codenames. So, stable not squeeze,
# testing, not wheezy. If you don't have any aliases, you may want to add them.

# Please remove this comment and the ones above.

#deb [arch=i386,amd64] https://ftp.example.org/example/ nextrelease main contrib non-free
#deb [arch=i386,amd64] https://other.example.org/example/ nextrelease main contrib non-free
#deb-src https://ftp.example.org/example/ nextrelease main contrib non-free
#deb-src https://other.example.org/example/ nextrelease main contrib non-free

#deb [arch=i386,amd64] https://ftp.example.org/example/ stablerelease main contrib non-free
#deb [arch=i386,amd64] https://security.example.org/example/ stablerelease main contrib non-free
#deb [arch=i386,amd64] https://backports.example.org/example/ stablerelease main contrib non-free
#deb-src https://ftp.example.org/example/ stablerelease main contrib non-free
#deb-src https://security.example.org/example/ stablerelease main contrib non-free
#deb-src https://backports.example.org/example/ stablerelease main contrib non-free

Last updated @TIME@