{"id":57824,"date":"2020-12-30T09:21:23","date_gmt":"2020-12-30T09:21:23","guid":{"rendered":"https:\/\/owncloud.com\/?p=57824"},"modified":"2021-01-04T15:49:05","modified_gmt":"2021-01-04T15:49:05","slug":"how-to-report-an-issue-on-github","status":"publish","type":"post","link":"https:\/\/owncloud.com\/de\/blogs\/how-to-report-an-issue-on-github\/","title":{"rendered":"Testing ownCloud Infinite Scale: How to report an issue on GitHub"},"content":{"rendered":"

First of all: Thank you for your interest in contributing to ownCloud! As an open source project, we both thrive and depend on getting feedback from our users. One of the most important ways to contribute is to report bugs (there is a tl;dr<\/a>). <\/p>\n

Let’s start with a real world example (don’t worry, the real-world issue behind the example was already fixed).<\/p>\n

Finding a bug in ownCloud Infinite Scale<\/h4>\n

Say you have installed the ownCloud Infinite Scale Tech Preview<\/a> and logged in as one of the test users, einstein. Now you would like to share a file with another test user, marie. After sharing the file, you log out and log in as marie. On the \u201cshared with me\u201d page, you accept the share from the share owner, einstein. if you then click on the share, you see that on the right side in the people accordion, marie is shown as the owner of the share. Since einstein is the share owner, one would expect it to show einstein. You\u2019ve found a bug! <\/p>\n

Report an issue on GitHub<\/h4>\n

Let’s go over to GitHub to create an issue for this, well, issue. Go to github.com\/owncloud<\/a>. From there, select the ownCloud repository that is most likely affected. In our case, it is the ownCloud\/ocis repository. <\/p>\n

Before we submit our issue, let’s make sure that it is not already known. Go to https:\/\/github.com\/owncloud\/ocis\/issues<\/a> and enter a plausible search term for your bug in the search field on the right of \u201cFilters\u201d. In our example, the words owner and people come to mind. Please take a look at the existing bug reports that fit the bill before posting your own so as not to create duplicate work. <\/p>\n

\"report

Before submitting your issue, see if it is already known<\/p><\/div>\n

If the error you encountered really is an as of yet unknown bug in ownCloud, let\u2019s report it. In the horizontal navigation bar right below the repository name, click on \u201cIssues\u201d, the second item from the left. On the right, click on the green button that says \u201cnew issue\u201d. You can also just enter https:\/\/github.com\/owncloud\/ocis\/issues\/new<\/a> in your browser address bar.<\/p>\n

It all starts with a good description<\/h4>\n

On this screen, we want you to describe the bug you encountered systematically. Please list the steps to reproduce<\/strong>, that means please describe step by step what you did to encounter the bug. In expected behavior, please describe what ought to happen, and in \u201cActual behavior\u201d, what happens instead. <\/p>\n

In our example case, the \u201csteps to reproduce\u201d are: log in as einstein. share a file with marie. Log out and log in as marie. On the \u201cshared with me\u201d page, accept the share. click on the share, then open the people accordion. \u201cExpected behavior\u201d would be something like: \u201cIn the people accordion item, Einstein is shown as the share owner\u201d – indicating the orderly state of affairs we strive for. In \u201cActual behavior\u201d, please describe the messy reality: \u201cIn the people accordion item, Marie is shown as the share owner\u201d. <\/p>\n

\"How

Please report the steps to repoduce, what ought to happen and what happens instead as well as a detailed profile of your system and the server<\/p><\/div>\n

Tell us what you’re working with<\/h4>\n

Then, please describe your system in detail, the client as well as the server. The operating system of the server and the client with the respective version number are as necessary as which browser or client or app you are using to access ownCloud Infinite Scale when the error occurs. <\/p>\n

Please also attach or paste the relevant client and server logs<\/strong>, if you can. If you have started ownCloud Infinite Scale as a binary from the command line interface, you can copy your server logs from there. If you are using Docker, open the Docker Interface, click on your instance and in the logs screen, just hit the copy button in the bottom right corner (see screenshot). <\/p>\n

\"docker

In the Docker GUI, copying the logs is particularly easy<\/p><\/div>\n

Also, the server version is relevant. When testing the ownCloud Infinite Scale Tech Preview, the server version is 1.0.0. To be better able to understand the problem, we also need to know the extensions and components you use with ownCloud Infinite Scale, such as the storage provider(s) and the way in which you provosion users. Unless you have manually set up something fancy, for the Tech Preview the storage provider is Reva and the identity provider is Kopano Konnect.<\/p>\n

We also need specifics about your client system<\/strong>. When testing ownCloud Infinite Scale, this is often the same as the server system<\/strong>. Let’s open the browsers\u2019 and the operating systems\u2019 about pages to find out which ones we are using. For the author of this text, it is Firefox for Mac 83.0 64bit on a Macbook Air running macOS Big Sur version 11.1. If you encounter an error while using the ownCloud Desktop Client, there now is a handy settings submenu to activate logging and quickly find the log files. <\/p>\n

\"\"

In the ownCloud Desktop Client, there is a handy settings submenu to activate logging and quickly find the log files<\/p><\/div>\n

If you encounter a bug in the browser interface using the ownCloud Web frontend, please also post your console output, you can find it via View->Developer->JavaScript Console in Chrome and via Tools->Web Developer->Console in Firefox. <\/p>\n

If you can, please also include screenshots or screencasts as attachments – they can make problems much easier to understand.<\/p>\n

When you have entered all this information, hit the green \u201cSubmit new issue\u201d. \u2028\u2028Thank you very much for your contribution to the ownCloud development! <\/p>\n

tl;dr? Here is a Checklist:<\/h4>\n
    \n
  • make sure the bug is unknown by searching the existing issues<\/li>\n
  • steps to reproduce\n
      \n
    • expected behaviour<\/li>\n
    • actual behaviour<\/li>\n<\/ul>\n<\/li>\n
    • screenshot(s) or screen video of the bug in action would be great<\/li>\n
    • note server characteristics\n
        \n
      • operating system, version<\/li>\n
      • ownCloud Infinite Scale version number<\/li>\n
      • list of components used (Identity, Storage and potentially others)<\/li>\n
      • server logs<\/li>\n<\/ul>\n<\/li>\n
      • client characteristics\n
          \n
        • operating system<\/li>\n
        • if relevant: browser, version<\/li>\n
        • if relevant: ownCloud Desktop Client, version<\/li>\n
        • client logs<\/li>\n
        • for browser interface errors: browser console log<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"

          We ask you to test the all-new ownCloud Infinite Scale to see its speed and scale for yourself. But what would you do if you find an error? When using open source software, you get to co-create even if you are not into programming. In this blog post we’ll show you how you too can report an issue on GitHub.<\/p>\n","protected":false},"author":7,"featured_media":57862,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_et_pb_use_builder":"","_et_pb_old_content":"","_et_gb_content_width":"","inline_featured_image":false,"footnotes":""},"categories":[509,43,240],"tags":[],"class_list":["post-57824","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-infinite-scale","category-blog","category-getting-started"],"acf":[],"_links":{"self":[{"href":"https:\/\/owncloud.com\/de\/wp-json\/wp\/v2\/posts\/57824","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/owncloud.com\/de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/owncloud.com\/de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/owncloud.com\/de\/wp-json\/wp\/v2\/users\/7"}],"replies":[{"embeddable":true,"href":"https:\/\/owncloud.com\/de\/wp-json\/wp\/v2\/comments?post=57824"}],"version-history":[{"count":4,"href":"https:\/\/owncloud.com\/de\/wp-json\/wp\/v2\/posts\/57824\/revisions"}],"predecessor-version":[{"id":57964,"href":"https:\/\/owncloud.com\/de\/wp-json\/wp\/v2\/posts\/57824\/revisions\/57964"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/owncloud.com\/de\/wp-json\/wp\/v2\/media\/57862"}],"wp:attachment":[{"href":"https:\/\/owncloud.com\/de\/wp-json\/wp\/v2\/media?parent=57824"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/owncloud.com\/de\/wp-json\/wp\/v2\/categories?post=57824"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/owncloud.com\/de\/wp-json\/wp\/v2\/tags?post=57824"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}