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

update rbts-docker.md #3406

Open
1 of 2 tasks
jessewashburn opened this issue Oct 11, 2024 · 4 comments
Open
1 of 2 tasks

update rbts-docker.md #3406

jessewashburn opened this issue Oct 11, 2024 · 4 comments

Comments

@jessewashburn
Copy link
Member

jessewashburn commented Oct 11, 2024

Please verify the following:

URL to the MDwiki page containing the problem

https://open-learning-exchange.github.io/#!./pages/robots/rbts-docker.md#What_is_Docker

Problem

This section has a bit of a "wall-of-text" feel to it. Also, the Docker Linux Containers link could be made more visibile. Also, I'm not familiar with a "BeLL-App," but I'm asssuming those L's are capitalized on purpose.

Screenshots (when necessary)

No response

Proposed solution(s)

Recommend breaking up the paragraph and inserting the link inside "Docker Linux Containers" See below:

However, to make this wiki coherent, we will talk a little bit about Docker. Docker is one of the implementations of container technology. Container technology implemented by Docker is the "younger brother" of virtual machine technology. With virtual machine technology, we can have a virtual computer inside a physical computer. And we can have more than one virtual machine if our physical machine is powerful enough. In different virtual machines inside a physical computer (say a server), we can install and setup applications like web application, network application, etc. This makes us easy to manage servers and make separation of some application in server easier. However, the main caveat of virtual machine is that it is resource hungry - meaning it takes a lot of processing power to do the virtualization. Although recent virtualization technology makes it more efficient, it still takes a lot of resources, and as you expect, another technology called container comes.

The concept of container technology uses the paradigm of shipping containers in inter-modal transport. The idea is that before shipping containers were invented, manufacturers had to be prepared to ship goods in a wide variety of modes – ships, trains, or trucks – with different sized containers and packaging. By standardizing the shipping container, goods could be seamlessly transferred among shipping methods without any additional preparation. Docker Linux Containers take the same approach with software. A container is a ready-to-use software package that can run in any operating system that supports it. For example, we can have a ready-to-use BeLL-App and when we want to install and run it in a new server, we can command the docker engine to run the container we have a working container. The software that packaged in a container share some part of the operating system of the host computer, but anything run in a container is isolated within a container.

@jessewashburn jessewashburn added the vi first steps - software engineering virtual intern label Oct 11, 2024
@jessewashburn
Copy link
Member Author

Apologies, this is not related to First Steps or Planet Manual, but rather, Contributors. I'll leave this here anyway though.

@RheuX
Copy link
Member

RheuX commented Oct 11, 2024

Yea, thats an awfully long paragraph about docker, splitting it up into 2 or 3 is nice for the readers

@xyb994 xyb994 changed the title Formatting to improve readability, link visibility in Docker paragraph update rbts-docker.md Oct 14, 2024
@xyb994 xyb994 removed the vi first steps - software engineering virtual intern label Oct 14, 2024
@xyb994
Copy link
Member

xyb994 commented Oct 14, 2024

Yes, this is an older documents. Aside from its structure, the content is a bit outdated as well.

@ssamikshaa
Copy link
Member

It's definitely a bit verbose and making it more concise and straightforward could help. I've also noticed that the BeLL app has been mentioned a few times in many of the pages. It might be beneficial to add either a page or a short explanation of what the BeLL app is to help users gain a better understanding of how it correlates to planet.

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

No branches or pull requests

4 participants