写技术博客的注意事项

本文详细介绍了撰写技术博客的12个注意事项,包括避免重复文档、全面总结、实践验证、网络资料引用、版本控制、精深原则、突出主题、使用通俗语言、事实依据、多读校改、清晰表达和专业写作技巧。通过遵循这些建议,可以提高博客的质量,使其成为有效的技术积累和分享工具。

个人认为写博客(Blogging)是技术总结的最佳方式,甚至可以这样子讲,博客就是积累,从一定角度上讲是酱紫的。可能是受规范约束习惯了,感觉写博客也有一些注意事项,虽然之前写了很多文章,但感觉都不是很规范,现总结写博客应该注意的几点,以随时提醒自己。

1. Do not Repeat Documents, link to it   不要重复文档,给出链接就好。重点写自己的心得,体会和总结。

对于那些在官方文档中都讲的很清楚的东西就没有必要再进行重复了,给出相应的链接就好了。特别是对于像MSDN这种非常丰富的官方文档,最好不要去重复它的内容,因为你不一定比官方讲的清楚。重点应该放在自己的心得,体会和总结等,这样于自己是真正的总结和积累,能变成经验,于他人也是一种有价值的参考的。

2. 进行全面的总结

前面说了不要重复文档,那应该写什么呢?愚认为,应该是自己经过实践之后的总结:

  • 把所有可靠的方法都说一下;
  • 把注意事项说一下;
  • 把各种方法进行比较,给出各自的优缺点和适用场合;
  • 文档中没有说明的情况,比如对文档的补充,或者文档有自相矛盾的地方。

3. 必须亲自实践进行验证,确保可靠可行。并附上实例(源码,资源)和运行结果(截图等)

4. 要总结与所谈内容相关且有价值的网络资料

5. 要列出参考资料,比如官方文档,别人的博客,源码等。这是对别人的尊重,也是对知识的一种尊重。

6. 可以参考,可以引用,但不要照搬,不思考式的抄袭。最重要的是要有自己的思考和理解。

如果是受他人的博客或代码的启发,最好把关键的句子段落引用出来,然后再写自己的思考和讨论。在文章中再给出原文或出处的链接,这样以显得尊重和专业。

7. 最好能有版本控制信息和修订记录

对于代码我们都有版本控制系统来帮助维护修改记录。但对于文档,也建议这样做。对于博客,可能没有(或许我不知道)类似的工具,但可以手动来说明。比如在博客的头部或尾部加上修订历史记录,或者在文章中把后来的修改用其他字体标明,或者用括号或脚注来说明。这样自已日后看起来也很方便,也能看到自己的思考过程和成长过程。

8. Less But Better精深原则

讲的越详细越好,范围越小越好,但要深入的讲,正如那句话,十个百分之十不如一个百分之百。如果你不能深入的讲,证明你还没有到写的时候,应试再去学习或者实践,直到你能讲的很清楚,讲的很详细,讲的很深入的时候再来总结和写博客。争取做到一篇文章一个点,这样文章多了就成了网最后变成没有漏洞的面。

9. 突出主题,分清主次,逻辑清楚,层次分明

这可能是对于写作的通用要求,说起来容易,但是做起来就比较困难。其实也不难,主要表现在:

  • 列表来罗列要讲的东西
  • 用标题先简明概括,然后再详细讲解
  • 标题与正文用不同的字体样式标识
  • 用字体和缩进来标识标题和正文

有没有一种感觉,这好像是在讲编码规范,没错,很早就有人讲过,写文章跟写代码是一样的。所以,作为程序员的我们,可以考虑用写代码的一切,包括习惯,规范来写文章。

10. 写完后多读几遍,进行校改

这就好比写完代码后的调试与测试。好代码是改出来的,好文章也是如此。能够一蹴而就的人有,但很少。即使是像鲁迅那样的大作家写文章都还需要修改,都没有一次成型的,更何况我们呢?在写完文章后也视情况对文章进行调试和重构,直到自己读起来感到满意和舒服为止。试想,如果自己写的文章自已都不想看,别人会看吗?我们又不是在写作业,不管好坏老师总会看,而且要仔细的看。要想写出好文章,必须首先让自己认为是好文章。

11. 用通俗易懂的平实的语言,对于专业术语要解释

好的技术文章应该都非常容易看懂,即使你对所说的那门科学完全不知。去读一读《Code Complete》等之类的经典书籍的英文原版,你会发现,其实看原版书并不需要多么NB的英语水平,可以不客气的讲上过大学的人应该都能看懂。其实这重点不在你懂不懂英语,而是要看作者能否用最易懂的语言来把事情表达清楚。这确实是一种能力,平常我们所谓的沟通能力,也基本上就在这,看你能否用最简单的语言把事情表达清楚,让另一方听明白。

这里有一些技巧:

  • 多用比喻,用大家熟悉的东西来比喻,这是让人最容易理解的一种方式。比如把软件构建比作建房子;把软件架构师比作楼房的设计师等。
  • 多用图示,用图解。很多时候一张图能抵上几百字的文字叙述,但还不一定能说明白。给出一张图就什么都明明白白了。
  • 图文并茂是讲解的最佳方式,合理的安排图片,再加之文字描述会达到事半功倍的效果。

12. 用事实说话

有图有真相,有代码有真相。说完了,讲过了,最好附上真实事例,代码和截图。否则别人可能会质疑,至少我在看到别人只“说”,没“做”的时候会质疑的。

<think>好的,我现在需要回答用户关于Java技术博客常见的版权注意事项的问题。首先,我得回想一下版权方面的基本知识,特别是针对技术博客的内容。然后,结合Java的具体情况,列出常见的注意事项。 首先,用户可能想知道在Java相关的技术博客时,如何避免侵犯他人的版权,以及如何保护自己的内容。常见的注意事项可能包括引用他人代码时的处理、使用开源许可证、避免抄袭等。 接下来,我需要分点整理这些注意事项,并给出每个点的解释。例如: 1. 引用他人代码的规范:比如使用代码块标注来源,或者获得授权。 2. 使用开源许可证:比如如果博客中的代码基于某个开源项目,需要遵守其许可证,如GPL、Apache等。 3. 原创声明:明确标明博客内容的版权归属,防止他人盗用。 4. 图片和资料的版权:使用的图片、图表是否来自免费资源或获得授权。 5. 避免侵犯商标:比如正确使用Java相关商标,如Oracle的Java商标。 6. 合理使用原则:在评论、教学等情况下引用他人内容是否符合合理使用。 然后,每个点需要详细解释,比如在引用代码时,应该注明原作者和许可证;使用开源代码时,要遵循对应的许可证要求,可能需要保留版权声明等。 可能还需要提到使用第三方库时的注意事项,比如在博客中展示如何使用某个库时,是否需要注明库的许可证信息。 另外,关于自己的博客内容,如何选择合适的许可证,如CC BY-NC-SA等,以及如何添加版权声明。 还要注意避免直接复制他人的教程或文章,即使是翻译,也需要获得授权。 现在,需要检查是否有遗漏的点,比如对Java官方文档的引用是否有特殊要求,或者Oracle对Java商标的使用规定等。例如,Oracle对Java商标的使用有严格规定,不能在未经允许的情况下用于商业用途。 最后,总结这些点,并按照用户要求的格式,先回答问题,给出解释,然后提出相关问题。 相关问题部分需要围绕版权、许可证、商标等方面提出,比如关于GPL许可证的要求、如何正确引用代码、Java商标的使用限制等。</think><< Java技术博客常见的版权注意事项主要包括以下六点: 1. **第三方代码引用规范** - 使用他人代码片段时需明确标注来源(作者+原始链接) - 若代码采用开源许可证(如MIT、GPL),需完整保留文件头部的版权声明 - 示例正确做法: ```java // 代码来源:Apache Commons Math库 // 原始地址:https://github.com/apache/commons-math // 许可证:Apache 2.0 Complex c = new Complex(1.0, 2.0); ``` 2. **开源许可证合规** - 使用开源库需遵守对应许可证要求(如GPL要求衍生作品也必须开源) - 示例:使用LGPL库时,修改后的代码需要开放源代码 - 建议在博客侧边栏添加整体许可证声明 3. **原创内容声明** - 在文章开头/结尾添加版权声明: ```text © 2024 YourName. 保留所有权利。 未经授权禁止转载或用于商业用途。 ``` - 对原创示例代码建议添加数字水印 4. **商标使用规范** - Java是Oracle的注册商标,使用时需添加商标声明: ```text Java™是Oracle和/或其附属公司的注册商标 ``` - 避免在域名/标题中出现"Java"字样(如javablog.com可能侵权) 5. **媒体素材授权** - 技术示意图建议使用draw.io等工具自建 - 使用第三方图片时需确认CC0/MIT等免费许可证 - 示例合规来源:Unsplash(需检查具体授权条款) 6. **合理使用边界** - 引用官方文档内容不超过原文10% - API文档示例代码可引用但需注明来源: ```text // 示例参考Oracle官方文档: // https://docs.oracle.com/javase/tutorial/java/data/numberclasses.html ```
评论 43
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值