You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+22Lines changed: 22 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,3 +1,4 @@
1
+
1
2
# Contributing to the Microsoft Graph SDK for Java
2
3
3
4
The Microsoft Graph SDK is available for all manner of contribution. There are a couple of different recommended paths to get contributions into the released version of this SDK.
@@ -22,3 +23,24 @@ Revisions of this nature will result in a 0.X.X change of the version number.
22
23
23
24
## Submit pull requests for model or request files
24
25
You can revise code in the extension folders of these folders. See [Extending the Library](https://github.com/microsoftgraph/msgraph-sdk-java/wiki/Extending-the-Library) for more information on how to work with the generated parts of the library.
26
+
27
+
## Add yourself as a contributor
28
+
29
+
This project follows the [all contributors](https://github.com/kentcdodds/all-contributors) specification. When making a contribution, please add yourself to the table of contributors:
30
+
31
+
1. In section 7. of the [README.md](https://github.com/microsoftgraph/msgraph-sdk-java/blob/master/README.md), after the last "|", copy and paste a new blank contributor element
<sub><b>Your Name</b></sub>](your website or github page)<br />
35
+
[emoji](link "alt-text") |
36
+
```
37
+
38
+
You can get your GitHub UID by inspecting your GitHub avatar image.
39
+
40
+
2. For each contribution type (see [emoji key](https://github.com/kentcdodds/all-contributors#emoji-key) for a list of contribution types), add an emoji and a relevant link and alt-text.
41
+
42
+
For example, if you write a blogpost on how to use the SDK, you would include:
Copy file name to clipboardExpand all lines: README.md
+13-16Lines changed: 13 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,22 +1,11 @@
1
1
# Preview Microsoft Graph SDK for Java
2
-
3
-
This client library is currently in private preview status. This means that:
4
-
- The API surface may change significantly.
5
-
- Non-blocking issues *may* be triaged at a slower pace.
6
-
- You may submit feedback through issues or PRs. You will have a better chance of your changes being implemented if they are submitted before public preview release.
7
-
- We do not define an SLA or support strategy for this library.
8
-
9
-
We welcome your feedback as we drive the quality of this to general availability.
2
+
*This SDK is currently in preview. Please continue to provide [feedback](https://github.com/microsoftgraph/msgraph-sdk-java/issues/new) as we iterate towards a production-supported library.*
10
3
11
4
Get started with the Microsoft Graph SDK for Java by integrating the [Microsoft Graph API](https://graph.microsoft.io/en-us/getting-started) into your Java application!
12
5
13
6
## 1. Installation
14
7
15
8
### 1.1 Install via Gradle
16
-
17
-
> [!NOTE]
18
-
> This package will not be available via Gradle until it is in public preview. You need to download the source and reference the package locally.
19
-
20
9
Add the JCenter repository and a compile dependency for `microsoft-graph` to your project's `build.gradle`:
@@ -46,9 +35,6 @@ An instance of the **GraphServiceClient** class handles building requests, sendi
46
35
For an example of authentication in a client application, see the [MSGraph SDK Android MSA Auth for Android Adapter](https://github.com/microsoftgraph/msgraph-sdk-android-msa-auth-for-android-adapter).
47
36
48
37
### 2.3 Get a GraphServiceClient object
49
-
50
-
<!--TODO: the following para needs expansion or removal. Would need to mention the different flows (authorization code flow, implicit flow, client credential flow) and give pointers on where to get sample code. Dave Moten can provide link for client credentials flow.-->
51
-
52
38
After you have set the correct application ID and URL, you must get a **GraphServiceClient** object to make requests against the service. The SDK stores the account information for you, but when a user signs in for the first time, it invokes the UI to get the user's account information.
53
39
54
40
```java
@@ -106,6 +92,17 @@ For known issues, see [issues](https://github.com/MicrosoftGraph/msgraph-sdk-jav
106
92
107
93
The Microsoft Graph SDK is open for contribution. To contribute to this project, see [Contributing](https://github.com/microsoftgraph/msgraph-sdk-java/blob/master/CONTRIBUTING.md).
108
94
95
+
Thanks to everyone who has already devoted time to improving the library:
This project follows the [all-contributors](https://github.com/kentcdodds/all-contributors) specification. Contributions of any kind are welcome!
105
+
109
106
## 7. Supported Java versions
110
107
The Microsoft Graph SDK for Java library is supported at runtime for Java 7+ and [Android API revision 15](http://source.android.com/source/build-numbers.html) and greater.
0 commit comments