1.程序员如何写好技术文档?建议收藏
2.慕课mooc和慕课网是不是一个?
3.èªå¦ç¼ç¨çappï¼
4.试验检测师道路工程哪个网校老师讲的比较好?
5.用Jenkins构建一个新工程,我们一起试一下!
6.Console 模块解读及简单实现
程序员如何写好技术文档?建议收藏
文档的范围很广,本文特指开发人员撰写的包含基本产品背景和主要技术设计的文档。
世界观为什么要写技术文档?
写技术文档可以帮助团队完成当前的信息共享和长期的知识传承。对个人而言,享钓地图源码一方面可以节省时间,因为避免了回答重复问题,也便于检索过去的知识;另一方面可以塑造口碑,比如某次突然有同事给我发消息说我的文档写的很好,对新接触这块业务的人帮助很大。
某某同事的感谢
反驳不需要写文档的言论
有很多程序员都持有一个观点:“不用看(写)文档,文档都在代码里”,还有一部分人认为,文档容易过时,很难跟上代码的更新节奏,因而没有必要写文档。
对此,首先我个人认为涉及代码细节的部分确实没必要写文档,但是对于总体的设计和业务的变更是绝对需要写文档的。有些人觉得文档有过时问题,那是因为他们没有引入版本(ChangeLog)的概念,过时的文档本身就是业务历史的一部分。在接手一个业务的时候,常常就需要这些历史信息来辅助理解。
附议:为什么要看文档
上周发生了一件趣事,一个产品跟我说,开发两句话能说明白的,为什么要看文档?确实,问开发能以最快速度准确地获取信息,毕竟人脑就是一个强大的搜索引擎。但是长期来看有以下问题:
一般来说,一份好的技术文档比起开发口述是不会有多余的理解成本的,甚至更低,拼车网源码下载因为对于很多信息,能比语言更好地表达。
什么算好的技术文档
我认为好的技术文档的核心是敏捷。一方面,好的的技术文档是高度可维护的并且经常维护的,比如新增了一些功能,文档的作者能够快速更新文档,文档的读者能及时获取更新;另一方面,好的技术文档是易理解的,更详细来说要表述准确、结构清晰、排版美观、风格统一。
文档&写文档的定义
最后,我想探讨下写文档到底是干吗?百度百科说:软件文档或者源代码文档是指与软件系统及其软件工程过程有关联的文本实体。那么写文档就是生产这个实体的过程了。但这样实在过于抽象,根据我最近一年的经验来看,我更愿意将其定义为对特定信息进行结构化整理的过程。
以上就是写作技术文档的道了,也就是我们对于这件事最基础的世界观,接下来谈术,即基于此执行的方法论。
方法论基调
在正式开始写文档之前,我们必须要有以下三点认知:
结构
本章节讨论了一份技术文档应该具备的各个单元,可以作为今后技术文档写作的框架或者Checklist。
Introduction
简单介绍项目背景信息,如下面是我为某个项目写的 Introduction :
Content
目录,目录是结构的直接体现,必须有,一般文档写作工具都能自动生成:
Terms
术语解释,很多业务会衍生一些特定词汇,如“白条卡”、安卓源码适配论坛“大图卡”等,都是有特定语境的,需要单独解释。
Setup
如何运行这个项目,一般开源项目都会有,如果是SDK文档也常常有接入文档,就是这个模块。
Body
这部分就是文档的主体部分,具体结构需要视内容而定,有以下通用规则
对于具体的格式规范,推荐阅读 ruanyf/document-style-guide: 中文技术文档的写作规范。
Reference
这部分也可以放在附录里面,见下图。
FAQ
其他人经常问的问题,遇到就记录在这个模块,不断补充,日趋完善。
Appendix
一些比较冗长的信息可以放在附录里面,比如日志,避免放在正文影响排版和阅读。
ChangeLog
变更日志,一般开源项目都会记录每个版本的重要变更。
ReleaseNote
发版日志,一般开源项目都会有一个单独的Release页面。
过程
一般来说,文档写作的流程如下:
收集信息、整理框架、实践结论、写作文档。如果前期工作足够,写作所花的时间是很少的。此外,文档完成后,源码公开课编程还要注意读者反馈,以不断完善自己的文档。写一份好的技术文档也不是一蹴而就的,需要不断打磨,要注意经常去刻意练习。
工具
写作工具
一般来说,只要别人发给我的文档是一份Word文档,我基本就把这份文档排在了最LowB的一档。对于这种文档,我就想问两点:为什么不是Markdown或Asciidoc格式?Markdown比较受开源社区的欢迎,因为它在表达力和简洁性之间找到了一个平衡点,但是它有一个致命问题就是无法应付稍微复杂一点的排版。Asciidoc则是我的主力文档工具,很多人不知道Github也是支持这种文档格式的,比如本文就是这种格式的。Asciidoc的语法比Markdown更加复杂,但我认为牺牲一点时间学习是完全值得的。最后是Latex,Tex的变种,表达力最强大,可以应付各种复杂排版,一般在学术圈比较流行(尤其是那些复杂数学公式的表达),但我认为放在日常的文档写作中有点矫枉过正了。
维护工具
对于文档的管理,我推荐使用Git,像管理代码一样管理文档。另外我推荐使用一个静态网站来存放自己的文档,这样其他同事访问的时候看到的总是最新的文档了。另外,公司目前在推iWiki,我觉得iWiki最大的优势是权限控制,对于一些敏感文档是必须的。但是工单任务系统源码,比起iWiki的变更记录,作为程序员的我更钟爱用Git进行管理,此外,iWiki是Web网页,编辑体验肯定也比不上本地自己配置的编辑器。当然,术没有绝对的优劣之分,也要看自己是否合适。
总结
以上,最近关于技术文档写作的一些思考。欢迎交流指正。
作者:慕用
链接:imooc.com/article/...
来源:慕课网
慕课mooc和慕课网是不是一个?
不是。慕课mooc是一个名词,指Massive open online course,大规模开放在线课程,是一种在线课程开发模式。
慕课网是一个网站,是IT技能教育的MOOC平台,设有前端开发、PHP开发,JAVA开发、Android开发及职场计算机技能等课程。课程分初级、中级、高级三个阶段。
慕课网是众多慕课mooc类平台中的一个。
扩展资料
MOOC教学形式
1、课程范围:以连通主义理论和网络化学习的开放教育学为基础。
2、授课形式:课程不是搜集,而是一种将分布于世界各地的授课者和学习者通过某一个共同的话题或主题联系起来的方式方法。
3、考试:每门课都有频繁的小测验,有时还有期中和期末考试。考试通常由同学评分(比如一门课的每份试卷由同班的五位同学评分,最后分数为平均数)。
MOOC平台:
1、Coursera:目前发展最大的MOOC平台,拥有相近门来自世界各地大学的课程,门类丰富,不过也良莠不齐。
2、edX:哈佛与MIT共同出资组建的非营利性组织,与全球顶级高校结盟,系统源代码开放,课程形式设计更自由灵活。
3、Udacity:成立时间最早,以计算机类课程为主,课程数量不多,却极为精致,许多细节专为在线授课而设计。
4、中国大学MOOC
5、Stanford Online:斯坦福大学官方的在线课程平台,与“学堂在线”相同,也是基于 Open edX 开发,课程制作可圈可点。
6、NovoED:由斯坦福大学教师发起,以经济管理及创业类课程为主,重视实践环节。
7、FutureLearn:由英国所高校联合发起,集合了全英许多优秀大学,不过课程要等到next year才会大批量上线。
8、Open2Study:澳洲最大MOOC平台,课程丰富, 在设计和制作上很下工夫,值得一看。
9、iversity:来自德国的MOOC平台,课程尚且不多,不过在课程的设计和制作上思路很开阔。
、Ewant:由两岸五大交通大学(上海交大,西安交大,西南交大,北京交大,台湾国立交大)共同组建的MOOC平台。
、WEPS:由美国与芬兰多所高校合作开发,开设多门数学课程。授课对象包括开设院校的在校学生,课程内容符合教学大纲要求,考试合格者可获得开设院校所认可的该课程学分。
慕课学习社区
、MOOC学院:最大的中文MOOC学习社区,收录了多门各大MOOC平台上的课程。有万学习者在这里点评课程、分享笔记、讨论交流。
、学堂在线:清华大学于年月日推出的MOOC平台,面向全球提供在线课程 [] 。
、慕课网(imooc):慕课网是由北京慕课科技中心成立的,是目前国内慕课的先驱者之一。现设有:前端开发、PHP开发,JAVA开发、Android开发及职场计算机技能等课程。其中课程包含:初级、中级、高级三个阶段。
、酷学习(kuxuexi):上海首个推出基础教育慕课的公益免费视频网站。
百度百科-慕课
慕课网-关于我们
èªå¦ç¼ç¨çappï¼
å¦ç¼ç¨ç软件æåªäº
å¦ç¼ç¨ç软件æï¼
1ãDev-C++
è¿æ¬¾è½¯ä»¶æ¯æ¥æåè½ç®æ´ãæå·§æ示åæ¯æå¤è¯è¨çä¼å¤ä¼ç¹ï¼æ¯å¨Windowsç¯å¢ä¸éååå¦è 使ç¨çä¸æ¬¾è½»é级C/C++éæå¼åç¯éæ¸å¢ã
2ãCodeBlocks
ä½ä¸ºä¸æ¬¾è½»é级çC/C++?IDEï¼å®é¤äºè½å¤å®ææåºæ¬çç¼è¾ãç¼è¯ãè°è¯çåè½ï¼è¿å ·å¤è·¨å¹³å°ãè·¨ç¼è¯å¨çç¹ç¹ï¼WindowsãLinuxãMac?OSé½å¯ä»¥ä½¿ç¨ï¼å³ä½¿å°æ¥æ´æ¢äºè®¾å¤ä¹æ éäºå¿µèæ é«è忧ã
3ãSublime?Text
è¿æ¯ä¸æ¬¾è½»é级çææ¬ç¼è¾å¨ï¼æ¯æå¤ç§è¯è¨çè¯æ³é«äº®å代ç è¡¥å ¨ãå ·æé«åº¦çå¯æå±æ§ä»¥å?Vim?模å¼ãSublime?Text?å ·ææ¼äº®çç¨æ·çé¢å强大çåè½ï¼ä¾å¦ä»£ç 缩ç¥å¾ï¼Python?çæ件ï¼ä»£ç 段çãSublime?Text?æ¯ä¸ä¸ªè·¨å¹³å°çç¼è¾å¨ï¼åæ¶æ¯æ?WindowsãLinuxãMac?OS?X?çæä½ç³»ç»ã
å è´¹å¦ä¹ ç¼ç¨ç软件å è´¹å¦ä¹ ç¼ç¨ç软件å¦ä¸ï¼
1ããç¼ç¨ç®ããè¿æ¬¾è½¯ä»¶æçå¤è¾¾åå¤å¹´çç¼ç¨æå¦ç»éªï¼é¤äºå¤§éçç¼ç¨è¯¾ç¨ä»¥å¤ï¼è¿ä¸º0åºç¡ç¼ç¨çåå¦ä¸é¨åå¤äºå ¥é¨è¯¾ç¨ï¼æå¦çè¯éç¨åå¦ä¹ åå®æçæ¹å¼ï¼ç¨æ·å¦ä¹ æçä¹å¾ä¸éã
2ããå¿ç«¥ç¼ç¨å¯èããè¿æ¯ä¸ä¸ºå©åæé çä¸æ¬¾ç¼ç¨å¯è软件ï¼è½¯ä»¶ä»¥å¨ç»ç§¯æ¨ä»£è¡¨ä»£ç ï¼è®©å ¶è½»æ¾äºè§£å°ä»£ç ç¼ç¨çåçï¼æ´æ积æ¨æåºã积æ¨ç§»å¨ç课ç¨è®©å©åå¦ä¼ç¼ç¨ãæ¯èµ·è®©å©åå¦ä¼å¤å°ç¼ç¨ç¥è¯ï¼è½¯ä»¶å¯æäºä¹ï¼æ´å¨æå¹å »å©å对äºç¼ç¨çå ´è¶£ã
3ããPythonç¼ç¨ç®ããç¼ç¨Pythonä¸é¡¹å¦ä¹ 软件ï¼é¤ææ课ç¨å 费为ç¨æ·å¼æ¾ä»¥å¤ï¼è¿å 广åï¼æ¯ä¸æ¬¾çæ£0é¨æ§çè¯å¿è½¯ä»¶ãç¨æ·æ¯è ç天åªéè¦æ¤åºåéçéªå罩ç¢çåæ¶é´ï¼å³å¯è½»æ¾ææ¡ç¼ç¨Pythonçåºç¡æè½ã
4ããç¼ç¨ç«ãã软件æ¥æ大éå¾ååãPythonçç¼ç¨è¯¾ç¨ï¼é¤äºæ¶çæå¦è§é¢ä»¥å¤ï¼è¿è¦é¹æä¸é¨é ç½®çç½ç»ç主任帮å©ç¨æ·å¦ä¹ ï¼å¦ä¹ ä¸æé®é¢æ¾ç主任ï¼æ³ç»ä¹ æ¾ç主任ï¼å¨è¿éå°ç½ä¹è½ç§ç¼ç¨å¤§å¸ã
5ããææºç¼ç¨ããåªè¦æ¥æä¸æ¬¾ææºï¼ä¸è½½è¿æ¬¾è½¯ä»¶ï¼å³å¯åæçµèç¼ç¨å¤§å¸ã软件å CãC+ãJacaåç½é¡µçç¼ç¨æå¦èµæé常å¤ï¼å¹¶ä¸éä¿ææï¼åªè¦ç¨æ·è±æ¶é´ï¼å³å¯è½»æ¾ææ¡ã
å è´¹çç¼ç¨èªå¦è½¯ä»¶å¯ä»¥èªå¦çç¼ç¨è½¯ä»¶å¦ä¸ï¼
1ããç¹ä¸ªç«ãç¹ä¸ªç«æ¯ä¸æ¬¾è¶£å³ç¼ç¨å¦ä¹ 软件ï¼éè¿æ积æ¨çæ¹å¼å¸®å©ç¨æ·å¦ä¹ ç¼ç¨è¯è¨ï¼é¶åºç¡ä¹è½è½»æ¾å ¥é¨ï¼ä¸°å¯çå¾å½¢å课ç¨ï¼è®©å¦è æ£ä½ äºè§£å±å¹æ´å¤ç¥è¯ç¹ï¼è¿æç¼ç¨åä½ç¤¾åºï¼å°ä¼ä¼´ä»¬å¯ä»¥ä¸èµ·å享交æµç¼ç¨ä½åã
2ããç¼ç¨å©æãæ¸ ç½ççé¢ï¼ç®åçæä½æ¸£æï¼æ¶µçç广çç¼ç¨è¯è¨ï¼å 容丰å¯å¤æ ·çç¼ç¨ç¥è¯ç¹ï¼æ³è¦å¦ä¹ ç¼ç¨è¯·ä¸è¦éè¿ç¼ç¨å©æè¿æ¬¾è½¯ä»¶ï¼æ¯å°ä¼ä¼´ä»¬è½»æ¾å¦ä¹ ç¼ç¨ç好帮æã
ç¨åºåå·é¢appæåªäºç¨åºåå·é¢appæå¦ä¸è¿äºï¼
csdnï¼
ç®ååä»ï¼è¶ ä¸ç¨æ·é½å¨ç¨çç¼ç¨å¦ä¹ Appã
æ 课ç½è¯¾ç¨appï¼
ç®ä»ï¼æ 课ç½ï¼imooc.comï¼æ¯ä¸ä¸ITæè½å¨çº¿å¦ä¹ ãå ¬å¼è¯¾å¹³å°ï¼å¼åå·¥ç¨å¸èªå¦å¿ å¤ç½ç«ã
ç¾æç¨åºåï¼
ç®ä»ï¼Javaç¼ç¨ç®æ¯W3Cschoolç¼ç¨ç®æä¸ä¸é¨ä¸ºé¶åºç¡Javaç¼ç¨ç±å¥½è æé çä¸æ¬¾å ¥é¨å·¥å ·Appï¼è´åäºå¸®å©åå¦è å ¥é¨ï¼è½»æ¾è¿å ¥ç¼ç¨é¢åãå¦Javaï¼ä»è¿éå¼å§ï¼
æè´ç¼ç¨å è´¹çï¼
ç®ä»ï¼"æè´ç¼ç¨å°å¸¦é¢ä½ å¨ä¸ç»æä¹é´ä»0å°1ææ¡ç¼ç¨å¥¥ç§ï¼ååºäººç第ä¸è¡ä»£ç ï¼å¸¦ä½ æå¼ç¼ç¨ä¸çç大é¨ï¼å¤©ç²¾épythonè¯è¨ï¼ææ¡ç¬è«çæ©ææ¯ãæ°æ®åææ¹æ³ï¼å ¥é¨äººå·¥æºè½ï¼æªæ¥ï¼å°±æ¯ç°å¨ï¼
Javaè¯è¨å¦ä¹ ï¼
ç®ä»ï¼Javaæç¨ï¼Javaè¯è¨è¯æ³ç¥è¯ï¼å æ¬è¢ä¸¾èJavaæ°æ®ç±»åãè¿ç®ç¬¦ãæ§å¶è¯å¥ãç±»å对象çè¯æ³ç¥è¯ã
ç客ç½ï¼
ç客ç½ï¼æ¯ä¸ä¸ªéç¬é¢è¯ç³»ç»ãé¢åºã课ç¨æè²ã社群交æµãæèå æ¨äºä¸ä½çæèç±»ç½ç«ãç客ç½é¢åºä¸å å«å ä¸éé¢ç®ï¼ä¸»è¦éè¿ç¬¬ä¸æ¹è´ä¹°åUGCçæ¹å¼è·å¾ï¼ç客ç½å åå°è¯äºç´æåå½æ课ï¼å 容è¦çç¬è¯é¢è§£æãé¢è¯æå·§åæºå¨å¦ä¹ çï¼æ ¡æï¼ä¸å®è¦å ³æ³¨ã
èªå¦ç¼ç¨è½¯ä»¶æåªäºï¼
1ãæ¡é¢ãæçå·¥å ·Onenote
onenoteå°±å纸质çç¬è®°æ¬ãæ¶éèµæãç¥è¯ç®¡çã强æçå¤å¶å¾åçæåï¼ç®ç´æ¯å¥½ç¨å°ä¸æä¹éè¦ä»ç»ã
2ãé 读/ç¼éæ祥å代ç ï¼Notepad++
毫ä¸å¤¸å¼ å°è®²ï¼è³å°ææ©æã%çç¨åºåç¨è¿è¿æ¬¾å·¥å ·ãè¿æ¬¾ç¼è¾å¨ç¡®å®æºå¥½çï¼æ¯æ代ç é«äº®æ¾ç¤ºï¼èä¸éç¨äºå¤ç§è¯è¨ï¼æada,php,java.c#,c++çã
3ãsublimetext3
SublimeTextå¨OSXãLinuxåWindowsä¸å¤§å¹³å°é½å¯ä»¥ä½¿ç¨ã
è¿æ¬¾ä»£ç ç¼è¾å¨æ¥æå¤éãå®ã代ç ç段çåè½ï¼å¹¶ä¸è¿ææå ·ç¹è²çMinimapã
4ãç¼å代ç :SourceInsight
ç¼å代ç é¤äºä½¿ç¨Notepad++ä¹å¤ï¼ä¹å¯ä»¥éæ©SourceInsightã
å®æ¯ä¸ä¸ªé常强大ç强大çç¨åºç¼è¾å¨ãå¯å¿«é访é®æºä»£ç åæºä¿¡æ¯çåè½ã
5ãæµç¨å¾visio
ç¨åºååæµç¨å¾ç软件ï¼å¾å°æå 款å¯ä»¥åVisio媲ç¾çãå®å¯ä»¥å°å¤æä¿¡æ¯ãç³»ç»åæµç¨å¯è§åãåæï¼éæåå°å¤§éç¨åºåçåç±ã
试验检测师道路工程哪个网校老师讲的比较好?
很多朋友都想利用闲暇时光学一点东西,但是想要自学,好的平台是很重要的,你是否也苦于没有好平台进行学习呢?现在就给大家整理了+个高质量学习网站+多位位高质量up主,特别适合大学生、职场人是、考研、高中生等群体。
总共划分为 8 个类目,B站、技能学习、综合学习、实习就业、文献资料、扩展视野、留学考研等,希望能帮到大家。
1. B站综合学习(6类目,个up主)
B站除了是一个二次元网站,同样也是一个高质量的学习网站。作为一名B站的深度使用者,在这里给大家分享 个超高质量的学习up主。
1.1 全能类软件教学(B站up主:Oeasy)
一位超级硬核的up主,在B站上拥有w+粉丝,上到编程入门、平面设计、Office技能,下到嘴硬核的电路设计,这位up主都有分享了非常详细的视频教程,并且整体的质量还非常不错,如果是想自学的,那么不妨可以看下,在B站学习,独特的弹幕文化交流,让学习像娱乐一样轻松。
链接:/
2.3 慕课网(程序员的梦工厂)
作为IT在线教育的Top1,有上千万人曾经在慕课网上学习过,参加最多的一门课甚至超过了w为程序猿,质量也是杠杠的,包含:HTML/CSS、大数据、Python、爬虫、云计算、Android、Java、小程序开发等等。
同时课程拥有免费+付费增值的形式,可以供你任意选择,为知识投资是最伟大的投资。
链接:mooc.org/home/index.mooc
7. 文献资料(6个网站)
7.1 学术堂(专业论文学习平台)
正逢需要写毕业论文的时间,如果还不懂的毕业论文是如何写的,那么这个网站一定要收藏好,包含了:范文、格式、题目、开题报告、摘要提纲、正文写作、参考文献等等,一系列的论文相关知识。
同时还非常良心地提供了众多论文模板:经济学、管理学、社会学、工程、水利、农业等等。
链接:ki.cn-ki.net/
7.3 云海电子图书馆(免费电子书下载)
学习的过程中难免会碰上寻找书籍,网上购买实体书速度又非常慢,而且有非常多的小伙伴希望看电子书,但是苦于没有一个下载电子书的地方,云海电子图书馆它来了!
在这里,你可以免费下载收录的所有电子书,涵盖了:投资理财、经济管理、小说、文学、励志成功、传记、健身与保健等等。
链接:/
7.4 网易数读(信息图参考)
一个非常有意思的的新闻栏目,利用可视化的精美来展示新闻,也是一个非常不错的信息文献借阅途径,无论对你写学术论文,还是了解时事都非常有帮助。
链接:blogs.com/wendingding/p/.html
5.FaceBook
.io
7.åå·§çææ¯å客
/s/blog_9c3cbfmz.html
.å客 loadViewãviewDidLoadåviewDidUnloadçå ³ç³»
blogs.com/ygm/p/.html
.ä½¿ç¨ Xcode å Instruments è°è¯è§£å³ iOS å åæ³é²
/mobiledev/.asp
.iOSå¼åä¸å¸¸è§çä¸äºbug
.io
.ViewControllerçåæ¢
/s/blog_4ca9ceefisvc.html
.iOS å¹³å° Cocos2d-x 项ç®æ¥å ¥æ°æµªå¾®å SDK çå
blogs.com/ios-wmm/
.èé¸ç¬è®°
blogs.com/hanyonglu/archive////.html
ã iOSå¼åå¤çº¿ç¨ç¯âå¤çº¿ç¨ç®åä»ç»
blogs.com/wendingding/p/.html
ãKVC ä¸ KVOç解
blogs.com/ios8/archive////ios-Singleton.html
. ä¸äºç¬¬ä¸æ¹åºçäºè§£
/thanklife/article/details/
2024-12-23 00:13355人浏览
2024-12-22 23:42614人浏览
2024-12-22 23:402455人浏览
2024-12-22 23:311422人浏览
2024-12-22 23:18942人浏览
2024-12-22 21:401349人浏览
今年六月端午連假第二天,中國籍阮姓男子駕駛小艇直闖淡水河口,逮捕之後向檢警表示,他是因為發表了對中國不利的言論,所以想要投奔自由。士林地檢署調查後認為,阮姓男子違反未經許可入國罪,偵結後提起公訴。違兩
1.html源代码包括哪两大部分?2.怎么查看自己网站的源代码?3.如何查看html源代码4.html源码是什么意思?html源代码包括哪两大部分? HTML的源代码主要由两个核心部分组成: