How to report a bug: Difference between revisions

From diaspora* project wiki
(→‎Reporting a Bug on GitHub: changed 'bug' to 'issue' where referring to Github issues.)
(Drop i18n template)
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Languages}}
Thank you for helping us make Diaspora better. :)<br />
If you want to start contributing [[How to work on bugs|by fixing a bug, here is how to]]. If you found a bug and want to report it, this is the correct page.


Thank you for helping us make Diaspora better. :)<br />
If you’ve found an issue with an '''existing feature''' in Diaspora, you can either
If you’ve found an issue with an '''existing feature''' in Diaspora, you can either


# report it using [https://github.com/diaspora/diaspora/issues Github issues],
# report it using [https://github.com/diaspora/diaspora/issues Github issues],
# report it in a public post on Diaspora with the #bug hashtag.
# report it in a public post on Diaspora with the #bug hashtag.
=== Reporting security issues ===
If you want to inform us about any security exploits in Diaspora, please contact us privately by sending an email to [mailto:security@diasporafoundation.org security@diasporafoundation.org], corresponding public key [http://pgp.mit.edu/pks/lookup?op=vindex&search=0x6F70243F27AD886A (keyID: 27AD886A)].


=== Reporting a Bug on GitHub ===
=== Reporting a Bug on GitHub ===
Line 18: Line 22:
# '''Monitor your issue and respond to questions.''' It may be necessary to provide additional information upon request or you might be asked if the bug still occurs after a new release.
# '''Monitor your issue and respond to questions.''' It may be necessary to provide additional information upon request or you might be asked if the bug still occurs after a new release.
# '''Close your issue.''' In case you notice that the bug no longer occurs, you can close the issue yourself (don’t forget to add a note saying the issue is resolved).<br>If you find out your bug is actually a duplicate of another bug and only notice that after you created it, please also close the issue you opened with a short reference to the existing issue (tip: if you use a # symbol followed by the number of the other issue, it will create a hyperlink to that issue).
# '''Close your issue.''' In case you notice that the bug no longer occurs, you can close the issue yourself (don’t forget to add a note saying the issue is resolved).<br>If you find out your bug is actually a duplicate of another bug and only notice that after you created it, please also close the issue you opened with a short reference to the existing issue (tip: if you use a # symbol followed by the number of the other issue, it will create a hyperlink to that issue).
=== Reporting security issues ===
If you wish to contact us privately about any security exploits in Diaspora you may find, you can email [mailto:exploits@joindiaspora.com exploits@joindiaspora.com], corresponding public key [http://pgp.mit.edu:11371/pks/lookup?op=vindex&search=0xCC6CAED977485064 (keyID: 77485064)].


= Feature suggestions =
= Feature suggestions =
Line 28: Line 28:
|Please '''don't''' use Github issues simply for suggesting a new feature.}}
|Please '''don't''' use Github issues simply for suggesting a new feature.}}


If you have a feature idea, the best place to suggest it is the [[How We Communicate#Mailing Lists|mailing lists]] or the [[How We Communicate#Loomio|Loomio platform]]. You can also make a public post on Diaspora with the #feature hashtag.
If you have a feature idea, the best place to suggest it is [[How We Communicate#Discourse|diaspora* Discourse]]. You can also make a public post on Diaspora with the #feature hashtag.


In case you want to discuss your idea first, before "officially" posting it anywhere, you can always join us on [[How_We_Communicate#IRC|IRC]].
In case you want to discuss your idea first, before "officially" posting it anywhere, you can always join us on [[How_We_Communicate#IRC|IRC]].

Latest revision as of 02:44, 15 October 2018

Thank you for helping us make Diaspora better. :)
If you want to start contributing by fixing a bug, here is how to. If you found a bug and want to report it, this is the correct page.

If you’ve found an issue with an existing feature in Diaspora, you can either

  1. report it using Github issues,
  2. report it in a public post on Diaspora with the #bug hashtag.

Reporting security issues

If you want to inform us about any security exploits in Diaspora, please contact us privately by sending an email to security@diasporafoundation.org, corresponding public key (keyID: 27AD886A).

Reporting a Bug on GitHub

  1. Register for an account on Github, if you don’t already have one.
  2. Search for similar issues. Perhaps someone has already reported your bug!
    If so, please add any new information or clarification to the existing issue, if you can.
  3. Create a new issue. If you don’t find any similar issues, you can report your bug via the “new issue” tab once you’ve logged in. Please, always include the pod you experienced the bug on and, if necessary, a link to the post that shows the symptoms or a screenshot showing what happened. Don’t be shy and specify as many details as possible -
    • what error message did you see,
    • did you publish a post publicly/to aspects,
    • were images attached to a post,
    • what pod is(are) the other user(s) on.
  4. Monitor your issue and respond to questions. It may be necessary to provide additional information upon request or you might be asked if the bug still occurs after a new release.
  5. Close your issue. In case you notice that the bug no longer occurs, you can close the issue yourself (don’t forget to add a note saying the issue is resolved).
    If you find out your bug is actually a duplicate of another bug and only notice that after you created it, please also close the issue you opened with a short reference to the existing issue (tip: if you use a # symbol followed by the number of the other issue, it will create a hyperlink to that issue).

Feature suggestions

NoteNote:Please don't use Github issues simply for suggesting a new feature.

If you have a feature idea, the best place to suggest it is diaspora* Discourse. You can also make a public post on Diaspora with the #feature hashtag.

In case you want to discuss your idea first, before "officially" posting it anywhere, you can always join us on IRC.