Questions tagged «source-code»

源代码是使用某种人类可读的计算机语言(通常是文本)编写的任何计算机指令(可能带有注释)的集合。

1
用Apache 2.0和我的修改文件
我以纯英语阅读了Apache License 2.0版的原始文本和说明。 好的,我复制世界最佳公司分发的课程,他们的许可证,然后稍微修改一下代码。 原始文件包含我的更改。 /* * Copyright (C) 2011 The Best Company in the World * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at …

11
“有趣的评论”是不好的做法吗?[关闭]
我想问你在源文档中添加一些“复活节彩蛋”是否不专业。也许您已经阅读StackOverflow的民调源文档中有趣的评论,我曾亲自在许多这样的事情我在工作中的公共API文档中跌跌撞撞,包括搞笑的(或不)的东西(例如该弱BZZZTT !! 1!事情在Android公共文档中,我至少可以提供更多示例。 我不能对我自己有最终的意见,因为我自己有矛盾的论点。 赞成论点: 它可以使某人振作起来,并使他/她的一天变得更加有趣/更有效率。源代码的主要部分无论如何都不需要注释(如果项目正确完成),因为特定的方法(例如)是不言自明的,或者如果它是一堆奇怪的cr脚代码,则不能会以有意义的方式进行解释,因此开个有趣的笑话不会损害您可以从文档中获得的可能信息。 缺点参数: 如果您非常专心/沮丧,那么您最后需要做的就是愚蠢的笑话,而不是给您有关文档代码部分所需的信息,这只会使您更加沮丧。如果所有人都开始这样做,那么文档的外观将是一个可怕的想法。另外,开玩笑的人可能是唯一认为这很有趣/有趣/值得浪费时间阅读的人。 你怎么看?

5
是否有关于重写软件成功/失败率的实际案例研究?
我已经看到多篇关于应用程序重写的文章,这些都是不好的,人们在Programmers上的经历,以及Joel Spolsky编写的关于该主题的文章,但没有确凿的证据或案例研究。除了Joel给出的两个示例以及此处的其他一些帖子外,您如何处理不好的代码库,以及如何根据实际研究决定如何处理它? 就目前的情况而言,我知道有两个客户端都具有旧的遗留代码。他们一直之以鼻,因为正如其中之一发现的那样,重写是一场灾难,这很昂贵,而且实际上并不能有效地改善代码。随着重写者迅速发现,该客户具有一些非常复杂的业务逻辑。 在这两种情况下,这些都是关键任务应用程序,可为公司带来大量收入。试图重写的人认为,如果将来某个时候不对旧版软件进行升级,它们将陷入困境。对我来说,这种风险需要进行研究和分析,以确保成功的道路。 是否有实际的案例研究对此进行了调查?我不希望尝试大量重写,而无需根据实际研究了解一些最佳实践,陷阱和成功。 后果: 好的,经过更多搜索,我确实找到了三篇有关案例研究的有趣文章: 重写或重用。他们对转换为Java的Cobol应用程序进行了研究。 另一个是关于软件重用:开发人员的经验和看法。 重用或重写关于维护与重写成本的另一项研究。 我最近找到了另一篇有关该主题的文章:The Great Rewrite。在那儿,作者似乎遇到了一些主要问题。随之而来的是通过使用建议的新技术堆栈并测量开发人员将其拿起的速度来进行原型制作的想法。这全都是重写的序幕,我认为这是个好主意!

14
处理源代码中的亵渎行为
人们如何处理源代码和VCS注释中的亵渎行为。保留还是删除? 像WTF或Arrgggh这样的软语词怎么办? 是不专业,令人反感的东西还是应该摆脱的东西?

5
现代软件产品中还剩下多少原始代码?[关闭]
你们当中许多人都在为大型公司提供知名软件。我想知道,现代大型应用程序(例如Firefox,Photoshop,Windows,Linux等)中还剩下多少原始代码(基本上是“ v1.0”版本的代码)?我真的更喜欢第一手经验和真实的战争故事。 感谢您满足我的好奇心。 编辑 原来有一定程度的误解。我所追求的基本上是以下内容:责备 / 注释源代码时,自最初的1.0版本以来,是否有任何部分甚至整个文件没有被修改过。

8
什么是精美代码?[关闭]
我经常读到开发人员必须编写漂亮的代码,但是对于我这样的初学者来说,对于什么是漂亮的代码以及您如何识别它仍然不甚了解。 必然的问题是:如何编写漂亮的代码以及提高代码质量的一些实践习惯?,我应该关心什么来使我编写的代码漂亮(以及应该学到什么)。


5
代码所有权是代码的味道吗?
自从我在有争议的编程观点线程中阅读此答案以来,我一直在思考以下问题: 你的工作是使自己失业。 在为雇主编写软件时,所创建的任何软件都应以任何开发人员都可以选择并以最小的努力理解的方式编写。它经过精心设计,清晰一致地编写,清晰地格式化,记录在何处,按预期每日生成,检入存储库并进行适当版本控制。 如果您遇上公共汽车,下岗,解雇或下班,您的雇主应该能够在短时间内通知您,然后下一个人可能会担任您的职务,接管您的代码,并做好准备。一周之内就可以跑步了。如果他或她做不到,那您就惨败了。 有趣的是,我发现有了这个目标使我对雇主更有价值。我越努力成为可抛弃型产品,我对他们就越有价值。 而且在其他问题(例如这个问题)中也进行了讨论,但是我想再次提出来从更空白的角度讨论“ 这是代码的味道! ”的观点-尚未真正涵盖深入。 我从事专业开发已经十年了。我曾经做过一项工作,代码编写得足够好,可以被任何体面的新开发人员相对迅速地拿到,但是在行业中的大多数情况下,似乎拥有很高的所有权(个人和团队所有权)规范。大多数代码库似乎都缺乏文档,流程和“开放性”,而这将使新开发人员可以选择它们并快速使用它们。似乎总是有很多不成文的小技巧和黑客,只有非常了解代码库的人(“拥有”它)才知道。 当然,明显的问题是:如果该人退出或“被公交车撞上”怎么办?还是在团队层面上:如果整个团队在团队午餐时外出时食物中毒,而他们全都死了怎么办?您是否可以相对轻松地用一组新的随机开发人员代替团队?-在过去的几份工作中,我完全无法想象这种情况的发生。这些系统充满了诡计和技巧,以至于您“ 只需要知道 ”,以至于您雇用的任何新团队所花费的时间远远超过可盈利的业务周期(例如,新的稳定版本)才能使事情恢复正常。简而言之,如果不得不放弃该产品,我不会感到惊讶。 显然,一次输掉整个团队是很少见的。但是我认为所有这一切中还有一个更微妙和危险的事情-这就是让我开始思考这个话题的要点,因为我以前从未看到过这些术语的讨论。基本上:我认为对代码所有权的高度需求通常是技术债务的指标。如果您“必须知道”系统中缺乏流程,沟通,良好的设计,许多小技巧和小技巧,等等-这通常意味着系统正在逐渐陷入越来越深的技术负担。 但是问题是-代码所有权通常被表示为对项目和公司的“忠诚”,是对工作“承担责任”的积极形式-因此,完全谴责它是不受欢迎的。但是,与此同时,等式的技术债务方面通常意味着代码库变得越来越不开放,并且使用起来更加困难。特别是随着人们的前进和新开发人员的到位,技术债务(即维护)成本开始飙升。 所以从某种意义上说,我实际上认为,如果对代码所有权的高度需求被公开认为是一种工作气味(在流行的程序员想象中),这对我们的职业而言将是一件好事。与其将其视为工作中的“承担责任和自豪感”,不如将其视为“通过技术债务巩固自己并创造人为的工作保障”。 我认为测试(思想实验)基本上应该是:如果这个人(或者实际上是整个团队)明天要从地球上消失,该怎么办?这是否会对项目造成巨大的伤害甚至是致命的伤害,还是我们可以招募新人员,让他们阅读doccos和帮助文件并使用代码几天,然后再返回在几周内完成业务(一个月左右即可恢复全部生产力)?


9
您对代码注释中的句点/句号有何看法?[关闭]
已关闭。这个问题是基于观点的。它当前不接受答案。 想改善这个问题吗?更新问题,以便通过编辑此帖子以事实和引用的形式回答。 5年前关闭。 我在SO Tavern中看到了这个问题,所以我在这里发布问题。我认为这是一个有趣的问题。(当然,它不属于SO,但是我认为在这里还可以。) 您是否在代码注释中添加了句点(或者,正如OP所写,“句号”)? 为了保持相关性,为什么?

2
如何编写代码文档,为什么软件(通常)文档记录不佳?
有一些很好的示例,这些示例都记录了很好的代码,例如java api。但是,公共项目(例如git和公司的内部项目)中的许多代码都没有很好的文档记录,并且不是很新手。 在我所有的软件开发工作中,我不得不处理文档记录不佳的代码。我注意到以下情况- 代码中很少或没有注释。 方法和变量名不是自描述的。 很少或没有文档说明代码如何适合系统或业务流程。 雇用不良的开发者或不指导好的开发商。他们不能编写简单干净的代码。因此,包括开发人员在内的任何人都很难或不可能编写代码。 结果,我不得不阅读大量代码并与许多人交谈以学习事物。我觉得这浪费了大家的时间。它还为项目的新手带来了KT /知识转移会话的需求。 我了解到,由于以下原因,文档没有得到应有的重视: 懒惰。 开发人员只喜欢编写代码就什么都不喜欢。 就业保障。(如果没有人能轻易理解您的代码,那么您可能就很难被替换。) 艰难的截止日期几乎没有时间记录在案。 因此,我想知道是否有一种方法可以鼓励和执行公司或项目中的良好文档规范。无论项目的复杂性如何,用于为任何项目的系统和代码创建体面文档的策略是什么?有什么很好的例子,说明什么时候需要最少的文档或根本不需要文档? 恕我直言,我认为我们应该在项目交付后对文档进行审查。如果它不简单,简洁,说明性和用户友好性,则开发人员或技术文档工程师将对此负责,并负责对其进行修复。我既不希望人们编写大量文档,也不希望它像第一本书一样对用户友好,但是我希望它消除了数小时的分析和浪费的KT会话。 有没有办法结束或减轻这种疯狂?也许是“文档驱动的开发”?

16
您认为代码是自我记录的吗?[关闭]
按照目前的情况,这个问题不适合我们的问答形式。我们希望答案会得到事实,参考或专业知识的支持,但是这个问题可能会引起辩论,争论,民意调查或扩展讨论。如果您认为此问题可以解决并且可以重新提出,请访问帮助中心以获取指导。 6年前关闭。 这个问题是多年前作为一次面试的研究生提出给我的,它时不时地困扰着我,我从来没有真正找到一个令我满意的好答案。 有问题的面试官正在寻找黑白答案,没有中间立场。我从来没有机会问过这个问题背后的原因,但是我很好奇为什么这个问题会交给开发人员,您将从是或否的答案中学到什么? 从我自己的角度来看,我可以阅读Java,Python,Delphi等,但是如果我的经理问我,问我在项目中走了多远,我说“代码已完成80%”(之前您开始将我击落,我听说过开发人员在几个办公室说过的话,那么自我记录到底有多准确?道歉,如果这个问题看起来很奇怪,但我宁愿提出询问并对此提出一些意见,以更好地理解为什么将其放在面试中。

7
您如何阅读他人的代码?[关闭]
已关闭。这个问题需要更加集中。它当前不接受答案。 想改善这个问题吗?更新问题,使其仅通过编辑此帖子来关注一个问题。 5年前关闭。 几乎每个高级程序员都说,阅读其他专业人员的代码非常有用。通常他们建议开源。 你读不读?如果这样做,读取代码的频率和程序是什么?而且,对于新手来说,处理SVN(一堆文件)有点困难。有什么解决方案?


30
什么是一些著名的一线或两线程序和方程式?[关闭]
按照目前的情况,这个问题不适合我们的问答形式。我们希望答案会得到事实,参考或专业知识的支持,但是这个问题可能会引起辩论,争论,民意调查或扩展讨论。如果您认为此问题可以解决并且可以重新提出,请访问帮助中心以获取指导。 6年前关闭。 已锁定。该问题及其答案被锁定,因为该问题是题外话,但具有历史意义。它目前不接受新的答案或互动。 我正在尝试一个新平台,并且试图编写一个处理不超过60个字符的字符串的程序,我想用一些著名的或众所周知的小代码块填充数据存储,方程式,因为编程和数学与我的软件主题保持一致。该代码可以使用任何语言,也可以使用来自任何数学学科的方程式,只要它们的总长度小于60个字符即可。我怀疑人们会为此而烦恼。 例如, #include<stdio.h> int main(){printf ("Hi World\n");return 0;} 完全是60个字符! 非常感谢您的智慧!

By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.