# Writing effective documentation for Discourse

**URL:** <https://meta.discourse.org/t/writing-effective-documentation-for-discourse/309628>\
**Category:** Contributing\
**Tags:** reference\
**Created:** [May 28, 2024, 4:24am UTC](https://meta.discourse.org/t/writing-effective-documentation-for-discourse/309628 "2024-05-28T04:24:22Z")\
**Posts on this page:** 1\
**Showing post:** 2

<div class="post-metadata">

**Author:** ![mcwumbly](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/mcwumbly/32/103861_2.png) [@mcwumbly](https://meta.discourse.org/u/mcwumbly)\
**Post date:** [May 31, 2024, 12:52am UTC](https://meta.discourse.org/t/writing-effective-documentation-for-discourse/309628/2 "2024-05-31T00:52:25Z")

</div>

@hugh / @SaraDev

I’m seeing a bit of inconsistency here about titles.

We have these examples:

> [@Discourse](#):
>
> Make titles action-oriented, ideally in the present continuous tense
> 
> - Incorrect: “How to enable automatic titles for Chat Threads”
> - Correct: “Enable automatic titles for Chat Threads”

But then we say this:

> [@Discourse](#):
>
> Use Associated Press title case - when in doubt, the [Title Case Converter](https://titlecaseconverter.com/) is a useful tool

If I put the “correct” example through the converter, I get this instead:

> Enable Automatic Titles for Chat Threads

Should we update our example to match?

> **aside**
>
> If it were just up to me, I’d have thought we’d go with sentence case, and I’m not sure why we have “Chat Threads” capitalized in the current topic title, so I’d _personally_ prefer to see this:
> 
> > Enable automatic titles for chat threads
> 
> But consistency is more important in the end and I’ll assume y’all have a good reason to have chosen the current recommendation.

---

_[View the full topic](https://meta.discourse.org/t/writing-effective-documentation-for-discourse/309628)._