标签：
目前源码和文档一般都是分开的，我在想为什么 源码不就是最好的文档么？
但是一般源码都是文本text的，格式化需要人为统一规范，所以源码中的文档在现实中不是那么的易于实践。
而且 源码 不能包括图片、附件、示例代码等资源，这个又是一个难点。
后来我突发奇想，为什么不能把xml作为一种合二为一的文档呢？
xml可被IDE识别，解析其中 包括 <code lang=cpp> 的标签中的文本为 代码。编译也使用这部分。
其他的标签 全部都是文档。而且可以在code 代码中 再分割，添加文档部分。
而文档部分，可以直接发布为纯文档格式的html文件，或pdf文件。
其实 doxygen 就是此类的工具，只是是基于文本的。而且是单独的工具。
如果IDE 支持也好。但是还是无法解决图片 附件 二进制的东西。
这个其实可以使用 BASE64 后放入xml，然后解析 在IDE中显示。
IDE 就好像在一个浏览器中编写代码。
这个实现起来挺难的。因为好用的IDE 都比较少。（我指开源 or 免费的）
目前最好用的C++IDE还是 Visual Studio 。而且2013 社区版 也免费了。
突发奇想之：源码及文档，文档包括源码---xml格式的源码，文档源码合并；注释文档化，文档代码化；
标签：
原文地址：http://www.cnblogs.com/ayanmw/p/4425730.html
