# Documentation and issue tracker

**URL:** https://forum.syncthing.net/t/documentation-and-issue-tracker/10741
**Category:** Meta
**Created:** [October 11, 2017, 1:47pm UTC](https://forum.syncthing.net/t/documentation-and-issue-tracker/10741 "2017-10-11T13:47:30Z")
**Posts on this page:** 4
**Page:** 1

<div class="post-metadata">

### Author: ![JonasKvarnstrom](https://forum.syncthing.net/user_avatar/forum.syncthing.net/jonaskvarnstrom/32/4637_2.png) [@JonasKvarnstrom](https://forum.syncthing.net/u/JonasKvarnstrom)
#### Post date: [October 11, 2017, 1:47pm UTC](https://forum.syncthing.net/t/documentation-and-issue-tracker/10741/1 "2017-10-11T13:47:30Z")

</div>

I see that there are quite a few issues reported to the issue tracker, and then closed because they should first have been discussed in the forum so that the developers can verify that there is actually a bug.

I’ve also noticed that one of the very first things stated at the top of the forum page is that one should “file bugs directly in the issue tracker” – to me this sounds like “don’t start discussing bugs here, please go directly to the tracker”. Of course this might only refer to definite bugs, but I don’t think this distinction would be clear to all users. Maybe clarifying this could help?

Also, the SyncThing documentation at [https://docs.syncthing.net/](https://docs.syncthing.net/) discusses the issue tracker _before_ it mentions the forum. Maybe switching the order could also help a bit? And explicitly stating the rules there as well (the distinction between reporting definite bugs in the tracker and “what you think is a bug” in the forum)?

In any case, thanks for a great piece of software!

---

<div class="post-metadata">

### Author: ![AudriusButkevicius](https://forum.syncthing.net/user_avatar/forum.syncthing.net/audriusbutkevicius/32/277_2.png) [@AudriusButkevicius](https://forum.syncthing.net/u/AudriusButkevicius)
#### Post date: [October 11, 2017, 1:51pm UTC](https://forum.syncthing.net/t/documentation-and-issue-tracker/10741/2 "2017-10-11T13:51:41Z")

</div>

The docs are maintained by the community, so feel free to improve.

---

<div class="post-metadata">

### Author: ![calmh](https://forum.syncthing.net/user_avatar/forum.syncthing.net/calmh/32/15311_2.png) [@calmh](https://forum.syncthing.net/u/calmh)
#### Post date: [October 11, 2017, 2:08pm UTC](https://forum.syncthing.net/t/documentation-and-issue-tracker/10741/3 "2017-10-11T14:08:02Z")

</div>

I’d welcome suggested improvements here.

---

<div class="post-metadata">

### Author: ![calmh](https://forum.syncthing.net/user_avatar/forum.syncthing.net/calmh/32/15311_2.png) [@calmh](https://forum.syncthing.net/u/calmh)
#### Post date: [October 12, 2017, 7:01am UTC](https://forum.syncthing.net/t/documentation-and-issue-tracker/10741/4 "2017-10-12T07:01:15Z")

</div>

> [@JonasKvarnstrom](#):
>
> the top of the forum page is that one should “file bugs directly in the issue tracker” – to me this sounds like “don’t start discussing bugs here, please go directly to the tracker”

I’ve removed this part above. I think it’s historical, and indeed we do prefer that people start their investigation in the forum and we don’t want to give the impression of referring people from one place to the other in a circle…
