| 英文 如何为此用户 FAQ 作贡献？ 我们欢迎和鼓励各种类型的贡献。下次当您或其他某个人饱受"如何...？"问题困扰时，这些贡献肯定会受到欢迎。 要添加新的 FAQ 或编辑现有的 FAQ，您必须先拥有一个帐户。如有必要，请单击页面顶部的"登录"。 如果您有与此 FAQ 有关的问题或建议，请发送电子邮件至 [docs@glassfish.java.net]。您可以通过 GlassFish 邮件列表页面订阅别名。 建议的贡献方法
-
- 为需要答案的问题发布答案*（问题列在 FAQ 主页的用户 FAQ 需求列表部分中）。或许您已被同一个问题困扰了很长时间，并最终解决了它。或许您在博客中谈到了相应主题，或者在某个问题一再地出现在其中一个论坛后，您解答了该问题。如果您有一些专门知识与大家分享，那就赶快发布吧！
-
- 发布您也有答案的新问题。*首先，请确保此 FAQ 尚不存在（如果存在，请参见下一条）。然后考虑一下此问题是否为常见问题。它是否为邮件列表上多次询问和解答的问题？它是否为很多人（尤其是新用户！）可能询问并需要帮助的问题？如果是，请添加此问题。
-
- 为其他某个人提出的 FAQ 添加更多信息。*如果您要添加的信息有利于现有 FAQ 的解决，请添加该信息。也许它是一个详细示例（示例很不错！）、一种在尝试了所有其他方法无效后突然有一天生效的解决方法或者人们应该知道的超酷技巧。
FAQ 格式 FAQ 条目应该使用相同的命名约定并遵循相同的格式。这一点确实很重要。请执行下列操作：
-
- 命名 wiki 页面时使用 Faq 前缀*，并使名称的剩余部分简短而具有描述性。例如，此页面的名称是 FaqContributeToUserFAQ。
-
- 按相应的类别添加新 FAQ。*如果 GlassFish 用户 FAQ 主页上未显示相应的类别，请添加该类别。还必须将相应的条目添加到主页上的"目录"中，以便人们可以轻松找到您添加的内容。请遵循此主页上其他条目的格式。
-
- 将您的问题作为标题重复列在答案页面上，并确保该问题与列在用户 FAQ 主页上的问题相符。*例如，问题_如何为此用户 FAQ 作贡献？既列在 GlassFish 用户 FAQ 主页上，又列在此答案页面顶部。一个需要更正的不相符示例是，问题_如何为此用户 FAQ 作贡献？_和答案_为此用户 FAQ 作贡献。
-
- 在答案开始处使用问题的中型标题*（!! 标记）。例如，此页面顶部的_如何为此用户 FAQ 作贡献？_具有稍大的文本和不同的颜色。这是使用 !! 标题标记实现的。
-
- 遵循几个简单的编辑准则。名称 GlassFish 具有*大写 F。例如，使用 GlassFish 而非 Glassfish。版本号用*小写 v* 指代。例如，使用 v2 或 v3 而非 V2 或 V3。还要使用*小写 v* 而非完整的单词 version。例如，使用 v3 而非 version 3。这种用法在 wiki 上显然不一致，但在添加新内容时应遵循。
FAQ 内容准则
-
- 确保 FAQ 是用户关注的而不是开发者关注的*，专门面向 GlassFish 用户而非 GlassFish 开发者。对于与开发者有关的问题，请转到 GlassFish 开发者 FAQ。
-
- 确保 FAQ 标题指明了某个人实际会询问的真正问题。*它应该简短而且切中要害，理论上长度不要超过一行，并提供所述主题的简明摘要。
添加新 FAQ
- 单击页面顶部的"登录"并进行验证。如果您还没有帐户，则需要注册一个。有关注册的更多信息，请参见如何注册？。
- 如果您还没在"GlassFish 用户 FAQ"页面上，请单击左侧的"GlassFish 用户 FAQ"。此时将显示"GlassFish 用户 FAQ"页面。
- 单击页面底部的"编辑"。除非您已登录，否则此"编辑"选项不可用。如果您已登录但此"编辑"选项不可用，请参见为何无法编辑 GlassFish Wiki 页面？。
- 滚动到相应类别（例如_安装_）并将您的问题添加到列表中，需遵循其他问题所用的格式并注意上面所列的准则。如果没有看到适用的类别，请创建一个。要点：如果您添加新类别，还必须将相应条目添加到"目录"中。请遵循其他条目所用的同一格式。
- 预览您的条目，必要时可进行修改，然后保存。
- 在"GlassFish 用户 FAQ"页面上的列表中单击您的问题，然后将相关内容添加到显示的主题页面。
- 预览您的内容，必要时可进行修改，然后保存。
编辑现有的 FAQ
- 单击页面顶部的"登录"并进行验证。如果您还没有帐户，则需要注册一个。有关注册的更多信息，请参见如何注册？。
- 如果您还没在"GlassFish 用户 FAQ"页面上，请单击左侧的"GlassFish 用户 FAQ"。此时将显示"GlassFish 用户 FAQ"页面。
- 单击您要编辑的 FAQ 的链接。此时将显示主题页面。
- 单击页面底部的"编辑"。除非您已登录，否则此"编辑"选项不可用。如果您已登录但此"编辑"选项不可用，请参见为何无法编辑 GlassFish Wiki 页面？。
- 编辑所显示页面上的内容。
- 预览您的更改，必要时可进行修改，然后保存。
|
