问题标签 [readability]

顺序异步调用很严重。有没有更易读的解决方案？

问题是这很难理解：

其中匿名函数是在服务器响应上调用的回调。

我正在使用第三方 API 进行 AJAX 调用，所以我需要一个通用的解决方案。

我是一名 java 程序员，但现在进入“python 领域”，以了解 Python 更适用的一些东西。我很确定我的大部分代码对于 Python 程序员来说看起来很奇怪（例如，在每个 if 上都使用括号）。

我知道每种语言都有自己的约定和一套“习惯”。那么，从可读性的角度来看，什么是 Java 中“要走的路”的约定和实践，但不是真正的“pythonic 方式”？

您将欣赏以下两种语法糖：

和

显然，每种情况下的第一个示例都更具可读性。有没有办法自己定义这种东西，无论是在 C# 语言中，还是在 IDE 中？我问的原因是，有许多类似的用法（长期的）可以从中受益，例如。如果您使用的是 ReaderWriterLockSlim，您需要一些非常相似的东西。

编辑1：

我被要求提供一个例子，所以我会试一试：

当然，您必须考虑如何使用 TryEnterReadLocks 以及那些有回报的东西。但我相信你能想到一些事情。

我喜欢 doctests，它是我唯一使用的测试框架，因为它写起来非常快，而且因为与 sphinx 一起使用，它几乎不费吹灰之力就能制作出如此出色的文档......

然而，很多时候，我最终会做这样的事情：

我的意思是我把我所有的测试和文档解释都放在了模块的顶部，所以你必须愚蠢地滚动才能找到实际的代码，这很丑陋（在我看来）。但是，我认为文档测试应该仍然保留在模块中，因为您应该能够在阅读源代码时阅读它们。所以我的问题来了：sphinx/doctests 爱好者，你如何组织你的 doctests，比如代码可读性不受影响？是否有针对 sphinx 的 doctests 样式指南？对于带有 sphinx 的文档字符串，您使用google 或 sphinx style-guide还是其他方式？

您发现什么是格式化 ASP.NET 标记文件（aspx、ascx）以提高可读性的最佳方式？任何提示和/或技巧？

我正在寻找关于缩进、换行、命名方案、<%-- --%>评论或任何你能想到的评论。

此代码修剪空白，（仅供参考：它被认为非常快）

while 循环没有括号，我如何正确地将括号添加到此代码中？

非常感谢！

我见过使用明确编号的重复而不是?,*和的正则表达式模式+，即：

问题是：

• 这两种形式是否相同？如果添加所有格/不情愿修饰语怎么办？
• 如果它们相同，哪一个更惯用？更具可读性？只是“更好”？

在 Perl 代码中最好地使用ifvs有哪些指导方针？unless在某些情况下是否有充分的理由偏爱其中一种？

我正在维护一些代码，并且发现了很多以下模式：

而不是这个：

有什么理由有人会这样做吗？有没有人认为前者更具可读性或更清晰？是否存在某种旧的 C“陷阱”？

我今天正在阅读一些代码（C，如果它对任何人都有影响的话）并且对开关块感到好奇。

现在，这是一个非常简单的开关块。这是some_function(some_var)我很好奇的-call：如果您，程序员，绝对，肯定，超级骗子确定调用将导致进程退出，即使完全没有必要，您是否仍将break-statement放在下面？你会说这是最佳实践吗？