头文件和cpp文件之间的实际设计差异

以Java为主要背景，我最近开始学习一些c++。我试图创建一个类来描述LinkedList。由于我希望这个类类似于一个外部库，因此我可以在其他应用程序中使用它，因此我需要将它声明为头文件。

我明白，从设计的角度来看，c++既需要头文件，也需要cpp文件，其中头文件将主要包含声明，实现将留给cpp文件。

我不明白的是上述设计技术的实际目的是什么。能够快速浏览头文件并阅读关于每个方法功能的注释对我来说似乎没有意义，因为c++(或至少我的Codeblocks编辑器)支持/**注释像Java一样，所以创建类的对象并简单地点击。按钮打开方法描述菜单，并以更有序和结构化的方式阅读任何我喜欢的描述，而不是通过头文件。

我还注意到，如果把所有的东西都放在头文件里，完全忽略cpp文件，程序运行得很好。

所以我的问题归结为我是否应该在头文件中实现所有内容，或者这是否被认为是不可接受的c++编码实践，如果是，为什么。