[gentoo-project] RFC: moving API-related DTDs into api.gentoo.org

[gentoo-project] RFC: moving API-related DTDs into api.gentoo.org

[Michał Górny]

[-- Attachment #1: Type: text/plain, Size: 696 bytes --]

Hi,

Right now all Gentoo DTS are stored in gentoo CVS repo for
www.gentoo.org. Since we already moved some useful stuff out of there
for api.gentoo.org, I think we should move the relevant DTDs as well.
In particular:

- metadata.dtd -- since it's used by different repositories and not
  really www.gentoo.org sites. It would be better if it had permanent
  api.gentoo.org URI for apps to fetch.

- mirrors.dtd -- used for mirror XML files stored in api.gentoo.org,

- repositories.dtd -- used for repository XML files stored in a.g.o.

And we should move more DTD as soon as respective XML files are moved
to api.gentoo.org.

Thoughts?

-- 
Best regards,
Michał Górny

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 949 bytes --]

Re: [gentoo-project] RFC: moving API-related DTDs into api.gentoo.org

[Ben de Groot]

On 24 March 2015 at 17:37, Michał Górny <mgorny@gentoo.org> wrote:
> Hi,
>
> Right now all Gentoo DTS are stored in gentoo CVS repo for
> www.gentoo.org. Since we already moved some useful stuff out of there
> for api.gentoo.org, I think we should move the relevant DTDs as well.
> In particular:
>
> - metadata.dtd -- since it's used by different repositories and not
>   really www.gentoo.org sites. It would be better if it had permanent
>   api.gentoo.org URI for apps to fetch.
>
> - mirrors.dtd -- used for mirror XML files stored in api.gentoo.org,
>
> - repositories.dtd -- used for repository XML files stored in a.g.o.
>
> And we should move more DTD as soon as respective XML files are moved
> to api.gentoo.org.
>
> Thoughts?
>
> --
> Best regards,
> Michał Górny

Makes sense. Let's do it.

-- 
Cheers,

Ben | yngwin
Gentoo developer

Re: [gentoo-project] RFC: moving API-related DTDs into api.gentoo.org

[Alex Legler]

[-- Attachment #1: Type: text/plain, Size: 1348 bytes --]

On 3/24/15 at 10:37 AM, Michał Górny wote:
> […]
> - metadata.dtd -- since it's used by different repositories and not
>   really www.gentoo.org sites. It would be better if it had permanent
>   api.gentoo.org URI for apps to fetch.

But neither has it really something to do with a file on api.g.o.
Its current URL on gentoo.org is just as permanent (even more so if it
isn't moved).
I fail to see the actual gain in moving it.

> 
> - mirrors.dtd -- used for mirror XML files stored in api.gentoo.org,

...and on the main website still.

> 
> - repositories.dtd -- used for repository XML files stored in a.g.o.
> 

That is the one fitting addition from your examples.

> And we should move more DTD as soon as respective XML files are moved
> to api.gentoo.org.

Quickly looking through the current DTDs, none belong to any files or
services that should be moving to the api site, except maybe glsa.dtd,
but that has its own site now anyway.

> 
> Thoughts?
> 

Taking into account that not everything belonging to these DTDs is on
api.g.o, we would be even hurting permanence of the URLs by moving them,
and the overall lack of a clear gain, I'd keep them on gentoo.org in one
central DTD location, i.e. the current gentoo.org/dtd/.

That being said, I'm all for having a separate git hosting them.


[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 801 bytes --]

Re: [gentoo-project] RFC: moving API-related DTDs into api.gentoo.org

[Mike Frysinger]

[-- Attachment #1: Type: text/plain, Size: 465 bytes --]

On 24 Mar 2015 13:52, Alex Legler wrote:
> Taking into account that not everything belonging to these DTDs is on
> api.g.o, we would be even hurting permanence of the URLs by moving them,
> and the overall lack of a clear gain, I'd keep them on gentoo.org in one
> central DTD location, i.e. the current gentoo.org/dtd/.

why can't g.o/dtd/ be a simple redirect to api.g.o/dtd/ ?  it makes sense in my 
mind for all the dtd files to live in api.g.o.
-mike

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 819 bytes --]