Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 607030 - overlays.gentoo.org should be moved to repos.gentoo.org
Summary: overlays.gentoo.org should be moved to repos.gentoo.org
Status: RESOLVED WONTFIX
Alias: None
Product: Websites
Classification: Unclassified
Component: Other (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Gentoo Website Team
URL: https://overlays.gentoo.org/
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2017-01-24 10:58 UTC by charles17
Modified: 2017-08-15 19:02 UTC (History)
4 users (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description charles17 2017-01-24 10:58:00 UTC
packages.gentoo.org should be moved to repos.gentoo.org

If possible use "301 Moved Permanently"
Comment 1 Mart Raudsepp gentoo-dev 2017-01-24 11:03:01 UTC
Huh, why? packages.gentoo.org lists packages in the main repository, not repositories
Comment 2 charles17 2017-01-24 14:18:30 UTC
(In reply to Mart Raudsepp from comment #1)
> Huh, why? packages.gentoo.org lists packages in the main repository, not
> repositories

Uhh, sorry. Site to be moved is overlays.gentoo.org
Comment 3 Mart Raudsepp gentoo-dev 2017-01-24 15:04:35 UTC
I hope those in favor of this terminology change can explain this to others in gentoo-project or gentoo-dev mailing list or something beforehand such big changes to the URL. I definitely do not agree with this terminology change, and I don't recall such discussions - however I was a bit away a year ago. Maybe there's some threads to simply point at that I can see and agree to.
In any case, I'm not website team
Comment 5 Kevin Vigouroux 2017-06-28 06:35:24 UTC
This bug is embarrassing! What term should we use?


* The Gentoo Handbook uses the terms "overlay" and "repository".

* The Wiki article is untitled "Ebuild repository" whereas the Gentoo project is named "Overlays".

* Some people want to change the denomination and others do not want. 


References:

-> https://wiki.gentoo.org/wiki/Talk:Ebuild_repository#Introduction_is_outdated.2Fobsolete

-> https://wiki.gentoo.org/wiki/Handbook:AMD64/Portage/CustomTree

-> https://wiki.gentoo.org/wiki/Project_Talk:Overlays


I think we should choose one of these two terms.
Comment 6 nm (RETIRED) gentoo-dev 2017-06-30 06:53:19 UTC
Infra has now setup repos.gentoo.org -- though there's no redirect from overlays.g.o.
Comment 7 charles17 2017-06-30 07:57:59 UTC
(In reply to Josh Saddler from comment #6)
> Infra has now setup repos.gentoo.org -- though there's no redirect from
> overlays.g.o.

Someone should also update the content of the title element which still is

<!DOCTYPE html>
<html>
  <head>
    <title>Gentoo Overlays</title>
Comment 8 Matthew Marchese Gentoo Infrastructure gentoo-dev 2017-06-30 20:40:00 UTC
I am in favor of using the term Ebuild repository, but I'm definitely open to having others weigh in on this. Ebuild repository describes the item exactly and is up-to-date in today's developer vocabulary. This may sound like a trivial reason to use the term, but I think it is very important to define terms (and goals for projects as well, but that's a different issue entirely!).

I am not in favor of using the term "custom tree", "overlay", or "package repository", although I've seen all these terms used before to describe the same item. 

1. "Custom tree" is way too generic of a term. "Tree" in computer science is an abstract data type. https://en.wikipedia.org/wiki/Tree_(data_structure)
2. The term 'overlay', although used in the past, doesn't provide very accurate connotations to the reader (especially in the vernacular of 2017). As far as I understand nothing is really "overlaid"; all the ebuilds are contained in separate repositories. The Gentoo ebuild repository is always separate from other ebuild repositories.
3. "Package repository" is simply misleading. Ebuild repositories to not contain packages (and they should never do so). They contain the ebuilds that are needed to install certain packages, but NOT the packages. :)
Comment 9 Matthew Marchese Gentoo Infrastructure gentoo-dev 2017-08-15 19:02:09 UTC
To reflect upon and revise my position, I am now in favor of using the term "overlay" as the colloquial reference to ebuild repositories. That is, ebuild repositories other than the main ebuild repository (gentoo.git). I have updated the wiki article with this terminology clarification: https://wiki.gentoo.org/wiki/Ebuild_repository

For non-native English speakers, 'colloquial' means 'informal'. This is perfect our our case for the reasons described above.

https://en.wikipedia.org/wiki/Colloquialism

This would make both terms (overlay and ebuild repository) equally valid, with overlay being the colloquial form and ebuild repository being the technical form. This also means that it is equality valid to keep both (and keep the redirect that was created as well).

I'm still not in favor of using the terms "CustomTree" (too generic) or "packages repository" (overlays don't hold packages, they hold ebuilds - scripts that contain instructions for how to customize and compile source code into packages).