Merge branch 'dev' into sync

Author: greenrobot

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,49 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: 'bug'
+assignees: ''
+
+---
+
+:rotating_light: First, please check:
+ - existing issues,
+ - Docs https://docs.objectbox.io/
+ - Troubleshooting page https://docs.objectbox.io/troubleshooting
+ - FAQ page https://docs.objectbox.io/faq
+
+**Describe the bug**
+A clear and concise description in English of what the bug is.
+
+**Basic info (please complete the following information):**
+ - ObjectBox version (are you using the latest version?): [e.g. 2.7.0]
+ - Reproducibility: [e.g. occurred once only | occasionally without visible pattern | always]
+ - Device: [e.g. Galaxy S20]
+ - OS: [e.g. Android 10]
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Put '...'
+2. Make changes to '....'
+3. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Code**
+If applicable, add code to help explain your problem.
+ - Include affected entity classes.
+ - Please remove any unnecessary or confidential parts.
+ - At best, link to or attach a project with a failing test.
+
+**Logs, stack traces**
+If applicable, add relevant logs, or a stack trace.
+ - For __build issues__, use `--stacktrace` for the Gradle build (`./gradlew build --stacktrace`).
+ - For __runtime errors__, check Android's Logcat (also check logs before the issue!).
+
+**Additional context**
+Add any other context about the problem here.
+ - Is there anything special about your app?
+ - May transactions or multi-threading play a role?
+ - Did you find any workarounds to prevent the issue?

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Question
+    url: https://stackoverflow.com/questions/tagged/objectbox
+    about: Ask how to do something, or why it isn't working on Stack Overflow.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,26 @@
+---
+name: Feature request
+about: Suggest an idea
+title: ''
+labels: 'feature'
+assignees: ''
+
+---
+
+:rotating_light: First, please check:
+ - existing issues,
+ - Docs https://docs.objectbox.io/
+ - Troubleshooting page https://docs.objectbox.io/troubleshooting
+ - FAQ page https://docs.objectbox.io/faq
+
+Start with a clear and concise description of what problem you are trying to solve.
+Often there is already a solution! 
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context (e.g. platform or language) about the feature request here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -4,6 +4,10 @@ apply plugin: "com.github.spotbugs"
 sourceCompatibility = JavaVersion.VERSION_1_8
 targetCompatibility = JavaVersion.VERSION_1_8
 
+ext {
+    javadocForWebDir = "$buildDir/docs/web-api-docs"
+}
+
 dependencies {
     api project(':objectbox-java-api')
     implementation 'org.greenrobot:essentials:3.0.0-RC1'
@@ -56,9 +60,10 @@ task javadocForWeb(type: Javadoc) {
     source = filteredSources + srcApi
 
     classpath = sourceSets.main.output + sourceSets.main.compileClasspath
-    destinationDir = reporting.file("web-api-docs")
+    destinationDir = file(javadocForWebDir)
 
     title = "ObjectBox Java ${version} API"
+    options.overview = "$projectDir/src/web/overview.html"
     options.bottom = 'Available under the Apache License, Version 2.0 - <i>Copyright &#169; 2017-2020 <a href="http://objectbox.io/">ObjectBox Ltd</a>. All Rights Reserved.</i>'
 
     doLast {
@@ -86,6 +91,8 @@ task javadocForWeb(type: Javadoc) {
                 "    color:#474747;\n" +
                 "    overflow:auto;\n" +
                 "}")
+
+        println "Javadoc for web created at $destinationDir"
     }
 }
 
@@ -96,7 +103,7 @@ task packageJavadocForWeb(type: Zip, dependsOn: javadocForWeb) {
     archiveFileName = "objectbox-java-web-api-docs.zip"
     destinationDirectory = file("$buildDir/dist")
 
-    from reporting.file("web-api-docs")
+    from file(javadocForWebDir)
 
     doLast {
         println "Javadoc for web packaged to ${file("$buildDir/dist/objectbox-java-web-api-docs.zip")}"

objectbox-java/build.gradle

@@ -0,0 +1,17 @@
+<HTML>
+<BODY>
+<p>
+    Welcome to the JavaDocs for <a href="https://objectbox.io">ObjectBox</a>, the super-fast database for objects.
+    On these pages, you will find the API reference for the ObjectBox Java library.
+</p>
+<p>
+    The <b>main documentation</b> is available at <a href="https://docs.objectbox.io">docs.objectbox.io</a> and offers
+    a changelog, a <a href="https://docs.objectbox.io/getting-started">getting started guide</a>, and many more topics.
+</p>
+<p>
+    GitHub links: <a href="https://github.com/objectbox/objectbox-java">ObjectBox Java</a>,
+    <a href="https://github.com/objectbox/objectbox-examples">Examples for Java, Kotlin and Android</a>
+</p>
+
+</BODY>
+</HTML>