Contributing to osv.io

[Matthew Kenigsberg]

Hi,

Is there somewhere I can contribute to docs on osv.io?

Thanks,

Matthew

[Dor Laor]

Sure, in the case of a single article, best is to post it to the list

for review and add a target location, if it's multiple changes, we

can eventually add you to the www github project

--
You received this message because you are subscribed to the Google Groups "OSv Development" group.
To unsubscribe from this group and stop receiving emails from it, send an email to osv-dev+u...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/osv-dev/c7dede83-c5c9-4bbb-ae8b-af900348f58en%40googlegroups.com.

[Waldek Kozaczuk]

Matthew,

Also if you have any ideas on how to improve look-and-feel or organization of it please let me know. I did some cleanup 1-2 years ago but I feel it needs more love.

Give me a couple of days to remember what the process of the update is and I will follow up on this email. I think it should be as easy as a pull request to proper repo.

Here is a starting point - readme in https://github.com/osv-io/osv-io.github.io and another repo - https://github.com/osv-io/blog. From what I remember osv.io uses Jekyll (it used to be octopress which I migrated to native Jekyll).

Waldek

[Matthew Kenigsberg]

Hi,

Couldn't find that repo, I was looking in cloudius-systems 🤦‍♂️

I'm looking at the "Learn More" portion of the site and I have a few ideas:

The separation between Design/Technology/Spinlock-free design doesn't seem very clear, and there's a section about spinlock-free design in the Technology section which seems like duplication.

I'm guessing this has been discussed before, but personally I felt like NewRelic and Jolokia JMX pages belong more on the wiki.

Wanted to ask about this partially to check my own understanding, but I think in Use Cases, FAQ, and maybe the home page, it should be made more clear how OSv relates to containers. As far as I can tell, in general OSv does not have a performance advantage over containers. Some of the docs talk about the benefit of eliminating context switching, which is an advantage compared to a full fledged VM, but there's still a context switch between KVM and the host OS. Techniques to eliminate that context switch (virtio-user/DPDK and SR-IOV) are also available to containers. If I'm understanding that correctly, I think the docs should more clearly reflect that OSv is a good alternative to Linux VMs, but it might not perform better than a container.

Let me know what you think of any of that!

Thanks,

Matthew

[Waldek Kozaczuk]

I agree with a lot of your sentiments. Just create a merge request with whatever you think.

Waldek

[Matthew Kenigsberg]

Will do, thanks!

Matthew

[Pekka Enberg]

Hi,

On Fri, Feb 12, 2021 at 12:08 AM Matthew Kenigsberg <matthewk...@gmail.com> wrote:

Couldn't find that repo, I was looking in cloudius-systems 🤦‍♂️

Slightly off-topic: I think it would be good to (eventually) consolidate the Github organizations. Perhaps move "osv.git" (and dependencies) under the "OSv" organization.

Regards,

- Pekka 

[Waldek Kozaczuk]

I approved your merge request. I think your changes are now visible now on osv.io.

Waldek

[Waldek Kozaczuk]

You mean osv from cloudious-systems to osv-io, or vice versa? Or create a new organization? How easy is it to move the repos? 

[Pekka Enberg]

Hi Waldek,

On Thu, Feb 18, 2021 at 1:45 AM Waldek Kozaczuk <jwkoz...@gmail.com> wrote:

You mean osv from cloudious-systems to osv-io, or vice versa? Or create a new organization? How easy is it to move the repos? 

Moving repositories is easy between organizations and Github preserves old URLs too. I would move everything to "osv-io", but that's for someone else to decide.

- Pekka