Questions tagged «standardization»

我曾在一家生产至关重要的软件的商店工作过，还处理过一些注释规则，这些规则旨在保持代码的可读性并可能挽救生命。以我的经验，尽管要求变成了脑筋急转弯的工作，需要从清单中剔除，但这并不能帮助我专注于编写可理解的代码。这也分散了我的同行审阅者的注意力，使我无法就如何使代码更易于理解进行更有意义的对话。 我还对没有注释的学生代码进行了评分，并查看了为什么应将它们标记为忽略它们。 我知道使用好名，使结构简单，函数简短，并关注模块将使代码易于理解，从而可以最小化注释。 我也理解注释应该解释为什么代码会执行此操作，而不是如何执行。 鉴于所有这些，甚至有可能编写出能够抓住这一想法的良好编码标准？与同行评审有关但不会变成漫不经心的清单活动，不会产生比以下内容更有用的注释：“您忘了在第42行发表评论”。 在清单中被视为一行时，此规则可能需要的代码示例： /* Display an error message */ function display_error_message( $error_message ) { /* Display the error message */ echo $error_message; /* Exit the application */ exit(); } /* -------------------------------------------------------------------- */ /* Check if the configuration file does not exist, then display an error */ /* …

142 coding-standards  comments  standards  naming-standards  standardization 

只是一个简单的问题，但是为什么今天仍然有如此多的文件系统在竞争和使用？（ntfs，fat32，ext3（ffs）等） 文件系统设计人员似乎可以就每种类型的系统的最佳方面达成共识，并实现“最佳”文件系统，不是吗？只是想一想，由于这些文件系统已经存在了一段时间，并且至少应该明显看出哪些文件系统具有优于其他文件系统的质量，我们可以将每个文件系统的优点结合起来，创建一个更好的最终系统

27 standards  file-systems  standardization 

我一直-std=c++0x在用GCC中的标志编译自己的代码，因为我想隐约地跟上所有年轻人的行为（前提是他们留在草坪上），最后我得到了很多警告关于auto_ptr被弃用 当然，我知道auto_ptr在C ++ 0x 中已弃用，但是... 弃用不是浪费时间和精力吗？不弃用的原因（以auto_ptr为例）： 仍然有大量代码需要得到支持，产生数百万条警告只会诱使人们关闭警告。 auto_ptr 是个小问题，但实际上确实可以做到。 如果我们真的想弃用东西，我提名printf()。但是，请想象将会发生的尖叫声。auto_ptr没有太多的朋友，但是至少在我的C ++代码中，它的使用量大于printf，根本没有使用。 该委员会对此有不好的记录-他们在名称空间范围内弃用了static，现在似乎已经弃用了-如果auto_ptr做出类似的复出，我不会感到惊讶 最后，无论委员会怎么说，编译器实施者都不会理ignore它们-他们根本不能冒险破坏客户代码，他们所能做的就是发出令人讨厌的警告。 所以我的问题是-您是否认为弃用（任何东西，不仅是auto_ptrs，而且不只是C ++）是个好主意，如果可以，为什么？

27 c++  c++11  standardization 

我真的很喜欢编程语言设计。有时，我认为我的语言项目及其潜在用户将从全面的标准文档中受益。我看过许多语言标准，从非常正式的（C ++）到相当非正式的（ECMAScript），但是我无法真正理解如何分解内容并组织这样的文档，即使我认为我总体上很擅长技术写作。 我应该像是一本很长的教程，还是更像是一份正规的数学论文来编写它？如果我正在与参考实现一起开发它，如何使其保持最新状态？我是否应该放弃并将实现和文档视为事实上的标准？此外，拥有标准真的有任何重大好处吗？要求标准是否意味着该语言不必要地复杂？

16 programming-languages  documentation  standardization 

我在一家控制系统公司工作，主要工作是SCADA和PLC以及其他控制系统。 除非决定创建内部项目管理和评估系统，否则软件开发实际上不是公司要做的事情。 这个项目最初是由来这里从事软件工作的人们承担的，我们大多是初级的。 该项目起初很小，所以我们只记录设计，数据库等内容，但我们从未真正同意编码格式/惯例。 我们开始使用StyleCop来确保我们已编写了完整的代码，但是我认为我们需要一个正式的文档来编写编码约定/实践，以便我们可以继续制定一个良好的标准，并且如果将来还有其他重要的开发工作（无论谁在此工作），具有良好的底板。 问题就出在这里，我不知道如何起草编码惯例和标准的文档，我所能想到的只是良好实践与不良实践的例子（例如，在命名变量，避免匈牙利符号等情况下的驼峰案例），我们都是能干足够的程序员（显然），但是我们只是没有关于这类东西的章程。 首先，我的问题是：好的编码标准文档的关键方面和内容是什么？

15 programming-practices  documentation  coding-standards  standardization 

您将如何定义标准？我正在为某种尚不存在的事物定义协议，我想为其创建一个RFC，并使用IANA提供的众所周知的端口号。我该如何开始？

13 standardization 

已关闭。这个问题是基于观点的。它当前不接受答案。 想改善这个问题吗？更新问题，以便通过编辑此帖子以事实和引用的形式回答。 4年前关闭。 编辑：如果您不熟悉odata，请前往这里。 我正在尝试确定是否值得学习这项技术，或者它是否会流行。 前提很有趣，作为API的开发人员，这似乎是向使用它们的开发人员提供更大灵活性的好方法。 不幸的是，在过去的几年中，我对开放数据协议没有太多的“嗡嗡声”，因此只是尝试评估一下一旦我学会了它，它是否有可能出现。 提前致谢。

13 api  web-api  standardization