2 ms·
Constructive criticism... this article suffers from the Curse of knowledge[1]. The telltale signs includes undefined terms and self-referential explanations wh
by jasode 9y ago
Constructive criticism... this article suffers from the Curse of knowledge[1].
The telltale signs includes undefined terms and self-referential explanations which means the tutorial is only understandable by those who already understand it.
Example excerpt:
- "Docker is an open platform tool to make it easier to create, deploy and to execute the applications by using containers. Containers allow us to separate the applications from the infrastructure so we can deploy application/software faster."
That type of explanation is only understandable to readers who already understand Docker.
Another sentence is probably missing phrase "instead of":
- "The Docker is like a virtual machine but creating a new whole virtual machine; it allows us to use the same Linux kernel."
Should probably be:
- "The Docker is like a virtual machine but [instead of] creating a new whole virtual machine; it allows us to use the same Linux kernel."
However, even the edited text would not be understandable by those new to Docker.
[1] https://en.wikipedia.org/wiki/Curse_of_knowledge https://en.wikipedia.org/wiki/Curse_of_knowledge