Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add security post on 2.1.5 #88

Merged
merged 2 commits into from May 31, 2023
Merged

add security post on 2.1.5 #88

merged 2 commits into from May 31, 2023

Conversation

hannesm
Copy link
Member

@hannesm hannesm commented May 25, 2023

from @reynir and myself.

@tmattio
Copy link

tmattio commented May 25, 2023

Thanks @hannesm! Same heads up as in #87: we're now featuring the platform blog in ocaml.org. The release announcements are now in the OCaml Changelog and the blog posts are in the OCaml Planet blog. Do you want to open a PR on ocaml.org with this blog post? These go in https://github.com/ocaml/ocaml.org/tree/main/data/planet/ocamlorg.

@hannesm
Copy link
Member Author

hannesm commented May 25, 2023

@tmattio thanks for your comment, but I'm a bit lost, is there any documentation how to move forward?

Last time I opened ocaml/ocaml.org#242 and thought that RSS/Atom would be automatically harvested and integrated into the OCaml planet.

Would you be able to clarify the process for "blog post", "planet blog", and "chagelog"? If I understand you correctly, each article now needs to be present in git repos thrice (or twice) -- which formats and UUIDs should be used? And there's really no syndication automation?

@rjbou
Copy link
Contributor

rjbou commented May 25, 2023

note: queued on ocaml/opam-repository#23820, ocaml/opam#5558 & #87

@tmattio
Copy link

tmattio commented May 25, 2023

Would you be able to clarify the process for "blog post", "planet blog", and "changelog"?

We're migrating opam.ocaml.org to ocaml.org. This started with the central package documentation (at https://ocaml.org/packages), now with the Platform blog, and next with the opam documentation.

The Platform blog was essentially composed of release announcements and blog posts. The release announcements have been integrated into the OCaml Changelog and the blog posts have been integrated into the Planet blog. The Planet is, under the hood, indeed an aggregate of RSS feeds, but since we don't have a feed for Platform posts, they are hosted on ocaml.org directly, e.g. https://ocaml.org/blog/signing-the-opam-repository.

If I understand you correctly, each article now needs to be present in git repos thrice (or twice)

Until we sunset opam.ocaml.org, I think it'd be best to cross-post the posts and announcements on the Platform blog and ocaml.org. We should make an announcement when we're ready to sunset opam.ocaml.org.

which formats and UUIDs should be used?

The markdown file you added here is good, the metadata format is slightly different on ocaml.org, but otherwise copy-pasting it is enough. Here's an example of the metadata for another Platform post on ocaml.org:

---
title: "Signing the OPAM repository"
authors: [ "Louis Gesbert", "Hannes Mehnert" ]
date: "2015-06-05"
description: "Proposal for a secure distribution of OCaml packages"
---

And there's really no syndication automation?

There is for community RSS feeds, and your blog is part of the syndicated RSS feeds. They can be added here: https://github.com/ocaml/ocaml.org/blob/main/data/planet-sources.yml

Hope this clarifies things! Let me know if anything is still unclear

@hannesm
Copy link
Member Author

hannesm commented May 25, 2023

Thanks for your reply.

Would you be able to clarify the process for "blog post", "planet blog", and "changelog"?

We're migrating opam.ocaml.org to ocaml.org. This started with the central package documentation (at https://ocaml.org/packages), now with the Platform blog, and next with the opam documentation.

I didn't know that.

The Platform blog was essentially composed of release announcements and blog posts. The release announcements have been integrated into the OCaml Changelog and the blog posts have been integrated into the Planet blog. The Planet is, under the hood, indeed an aggregate of RSS feeds, but since we don't have a feed for Platform posts, they are hosted on ocaml.org directly, e.g. https://ocaml.org/blog/signing-the-opam-repository.

Does https://opam.ocaml.org/blog/feed.xml not count?

If I understand you correctly, each article now needs to be present in git repos thrice (or twice)

Until we sunset opam.ocaml.org, I think it'd be best to cross-post the posts and announcements on the Platform blog and ocaml.org. We should make an announcement when we're ready to sunset opam.ocaml.org.

which formats and UUIDs should be used?

The markdown file you added here is good, the metadata format is slightly different on ocaml.org, but otherwise copy-pasting it is enough. Here's an example of the metadata for another Platform post on ocaml.org:

---
title: "Signing the OPAM repository"
authors: [ "Louis Gesbert", "Hannes Mehnert" ]
date: "2015-06-05"
description: "Proposal for a secure distribution of OCaml packages"
---

I see. I'll try to find time for ocamlorg once this PR here is merged. I won't promise anything.

And there's really no syndication automation?

There is for community RSS feeds, and your blog is part of the syndicated RSS feeds. They can be added here: https://github.com/ocaml/ocaml.org/blob/main/data/planet-sources.yml

Hope this clarifies things! Let me know if anything is still unclear

@tmattio
Copy link

tmattio commented May 25, 2023

Does https://opam.ocaml.org/blog/feed.xml not count?

It does, as the goal is to sunset opam.ocaml.org, it makes little sense to add a dependency on the opam RSS feed to migrate it to ocaml.org.

I see. I'll try to find time for ocamlorg once this PR here is merged. I won't promise anything.

Thanks! It'd be ideal to have concurrent PRs so we are not constantly tracking which posts we forgot to replicate to ocaml.org.

opam-2-1-5-local-cache.md Outdated Show resolved Hide resolved
@rjbou
Copy link
Contributor

rjbou commented May 31, 2023

thanks!

@rjbou rjbou merged commit 2d76df3 into ocaml:master May 31, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants